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ABSTRACT 



The goal of this work is to develop a text-based script interpretation system for easy 
and efficient 3D visual simulations without extensive programming. Scripts are 
sequences of events representing task-level behaviors in virtual worlds systems. The 
Object Animation Script Interpretation System for NPSNET (NPSNET-OASIS), 
provides animators at the Naval Postgraduate School a mechanism for interacting with 
3D visual simulations via scripted autonomous players. Libraries of scripts are collected 
for rapid generation of 3D visual simulations. NPSNET-OASIS makes use of object- 
oriented design methodologies for reusability and extensibility. Included in NPSNET- 
OASIS are the object tools for script processing, writing, and sorting. 
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I. THE NEED FOR SCRIPT ANIMATION LANGUAGES 



A. INTRODUCTION 

The Graphics and Video Laboratory of the Computer Science Department at the 
Naval Postgraduate School (NPS) has a long history of developing 3D visual simulation 
systems on inexpensive, commercially available graphics workstations [Ref. 10]. The 
visual simulators developed in the Graphics and Video Laboratory include the FOG-M 
missile simulator, the VEH vehicle simulator, the Airborne Remotely Operated Device 
(AROD), the Moving Platform Simulator series (MPS-1, MPS- 2, and MPS-3), the High 
Resolution Digital Terrain Model (HRDTM) system, the Forward Observer Simulator 
Trainer (FOST), the NPS Autonomous Underwater Vehicle simulator (NPSAUV), and the 
Command and Control Workstation of the Future system (CCWF). Current visual 
simulation efforts are focused on the NPSNET system, a 3D visual simulation system that 
utilizes SIMNET and DMA databases. 

NPSNET is a real-time, 3D visual simulation system capable of displaying various 
types of vehicles - ground, ships, and aircraft [Ref. 10]. The system is capable of 
displaying additional objects such as missiles, buildings, trees, and environmental effects, 
such as fog and smoke. Objects are represented initially by pre-defined 3D icons stored in 
Object File Format (OFF) [Ref. 9]. 3D icons are geometric descriptions of 3D objects. 
Vehicle movements in NPSNET are controlled by mouse, spaceballs, and button/ 
dialboxes. In addition, vehicles can be driven interactively from other workstations by 
means of message packets via Ethernet. 

In any simulator, the backbone of the system is its internal data structures for 
modeling the state of the world [Ref. 10]. It is from the world state information that visual 
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displays are generated. Continuous and transient events are referred to as task-level 
behaviors in virtual world systems [Ref. 1]. Continuous events are dynamic changes in 
motion of 3D icons. Transient events are dynamic changes of appearances in virtual 3D 
icons, such as explosions and collisions. 

When sufficient numbers of actual interactive players are not available, the Graphics 
and Video Laboratory requires two methods for generating autonomous players to 
populate the world - semi-automated forces and scripting [Ref. 10]. Currently in 
development, semi-automated forces provide intelligent behavioral models to autonomous 
players via parallel processing and the network. Scripting provides a programmable 
mechanism to add autonomous agents or to change task-level behaviors of 3D icons. 

The script system, the Object Animation Script Interpretation System for NPSNET 
(NPSNET-OASIS), was developed to meet the requirements of scripted autonomous 
players. Designed using object-oriented methodologies, NPSNET-OASIS provides the 
capabilities to record and playback scripts of task-level behaviors. Scripts in NPSNET- 
OASIS are generated as sequences of events in uniform order based on timestamps. 
Unlike current systems which are coded in standard C, NPSNET-OASIS is programmed 
in C-H-, thus allowing reusability and extensibility. Several instances of NPSNET-OASIS 
can be integrated into NPSNET, allowing the simultaneous execution of multiple scripts. 

B. BACKGROUND 

There are two interaction paradigms in virtual world systems - guiding and 
programming [Ref. 1]. Guiding is interaction with objects from built-in procedural 
support and specially-designed graphics hardware. Programming is interaction with 
objects using special-purpose simulation software for algorithmic description and control. 

The principles of software engineering are applied to natural script languages in an 
effort to provide a more flexible, extensible, and efficient interactive tool for visual 
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simulators [Ref. 5]. Libraries of scripts can be generated and reused, allowing fast 
prototyping of simulated engagements and tactics. Simple in design and use, scripts are 
basically procedures for controlling 3D icons. Combining scripts to create larger ones, 
supports modular scripting in a high-level of programming. In LISP-based systems, the 
rules of the script language are extensible so that new animation procedures and primitives 
can be added to the system. Easier to learn than complex languages, script languages can 
develop animation scripts faster than a functionally equivalent Ada or C program. 

The basis for our research in script systems is on three earlier systems - ASAS, PDI, 
and MANUS. Based on the LISP language, Actor/Scriptor Animation System (ASAS), is 
a full programming language system for animation and graphics [Ref. 6]. ASAS supports 
independent program structures called actors, and includes a set of geometric objects and 
operators. Geometric objects include data types such as vectors, colors, polygons, solids, 
and lights. Actors are responsible for geometric objects in an animation sequence. 
Geometric operators are the tools the animator uses to shape, move, and orient geometric 
objects. 

Influenced by ASAS, Pacific Data Images (PDI) developed a script system on top of 
the C programming language for creating animation in the entertainment field [Refs. 3, 5]. 
The PDI script system supports complex modeling, transformations, and motion. At each 
production stage, the script is updated to reflect production changes, and to incorporate 
new models and motion data from other parts of script system. 

BOLIO, an integrated graphical simulation platform (IGSP), provides users tools to 
interact in simulation of task-level behaviors, and event-driven processes in virtual worlds 
[Refs. 1, 8]. A component of BOLIO, MANUS, provides the built-in language and 
processor for associating objects and processes in defining task-level behaviors. 
Programmers have access to primitive operations of kinematics and dynamics in a 
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modular function library. Complex scripts are used for testing and debugging various’ 
simulation modules, or for defining virtual environments 

C. SUMMARY OF CHAPTERS 

The development of NPSNET- OASIS involves understanding of required task-level 
behaviors of NPSNET and other 3D visual simulators of the Graphics and Video 
Laboratory. In Chapter II, the design of the script system is discussed. Chapter HI 
discusses the overview of NPSNET-OASIS. The interaction of NPSNET-OASIS with 
NPSNET is discussed in Chapter IV. Limitations and future directions are the subjects of 
Chapter V. Appendices include syntax for script events and script options, listings of 
script results and script errors, sample scripts, and object class descriptions for NPSNET- 
OASIS. 
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II. DEVELOPMENT OF NPSNET-OASIS 



A. DESIGN CRITERIA 

The goal of NPSNET-OASIS is to build a scripting system that is reusable and 
extensible. In addition, NPSNET-OASIS must be simple for system integration. Previous 
3D visual simulators in the Graphics and Video Laboratory were developed with traditional 
programming languages such as C, and are not easy to maintain. Whenever, a modification 
is made, the entire system is affected. The design of NPSNET-OASIS must be capable of 
being adapted easily as modifications are made to NPSNET. 

B. OBJECT-ORIENTED DESIGN 

The concept of object-oriented design (OOD) involves solving problems by 
identifying the real-world objects of the problem, and the processing required of those 
objects [Ref. 2]. For this reason, all components of NPSNET-OASIS are represented as 
objects. Classes in object-oriented design, distinguished in italics text, are templates for 
categories of objects, and provide the means for creating objects. Because objects serve as 
data abstractions, classes must include data structure definitions and the processing code 
for instances of those data structures. 

1. Class Hierarchy 

OasisObject is the root class of the NPSNET-OASIS class hierarchy, as other classes 
in the hierarchy are derived from it. The main descendants of OasisObject - 
OasisSystemObJect and OasisEventObject, represent the main components of NPSNET- 
OASIS (Figure 2.1). OasisSystemObJect represents the base class for all system 
components in script processing, script generating, and script sorting. OasisEventObjects 
represents the base class for all task-level behaviors in 3D icons. For illustrative purposes. 
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classes of NPSNET-OASIS are segmented from the total class hierarchy, and are 
represented as ellipses with arrows pointing to descendants. 

2. Event Objects 

Each ScriptEvent is composed of an EventObject, EventPosition, TimeStamp, and 
Event Attribute, which are descendants of OasisEventObjects (Figure 2.2). EventObjects 
provide identification of 3D icons in events, and EventPositions provide the locations of 
the events. For every ScriptEvent there is a TimeStamp, which provides the time 
mechanism to synchronize all events in uniform order. For additional information in 
supporting task-level behaviors of 3D icons, Event Attributes are used to represent the 
change of continuous and transient events (Figure 2.3). 

Presented in Figure 2.4 are the six classes of script events - VehicleEvent, 
WeaponEvent, MiscObjectEvent, EnvironmentEvent, ScriptOption, ScriptComment, and 
ScriptOption. ScriptComment and ScriptOption do not represent script events. However, 




Figure 2.1 Root Class of NPSNET-OASIS Class Hierarchy 
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script events are supported by them for descriptive narrations in script files and script 
synchronization. Communicating with script events, ScriptObjects are the interfaces for 
passing messages of task-level behaviors to and from 3D icons. ScriptObjects interact with 
virtual world systems for controlling and recording continuous and transient events. 

3. System Objects 

There are four parent classes for OasisSystem - ScriptFile, ScriptProcessor, 
ScriptGenerator, and TimeKeeper (Figure 2.5). Classes are derived from 
OasisSystemEvents for supporting system requirements of NPSNET-OASIS. ScriptFiles 
provide the mechanism for interacting script files with script systems. EventProcessor is 
the base class for the required event processors to the ScriptProcessor. ScriptProcessor is 
the tool for interpreting and processing of all script files. The script writer of NPSNET- 
OASIS, the ScriptGenerator, records all script objects to a script file. The last parent class, 
the TimeKeeper, provides the system times for processing and recording script files. 
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Derived from OasisSystem, are two additional object classes for NPSNET-OASIS 
(Figure 2.5). OasisScriptPreprocessory is a preprocessor for validating script files prior to 
processing. Script errors are displayed for further script modification. The second object 
class, OasisScriptSorter, provides the sorting of script events based on time stamps. This 
tool ensures all script events are in uniform order. 
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C. NPSNET-OASIS SCRIPT FORMAT 



All script files for NPSNET-OASIS are in text-based format allowing the user to use 
any standard text-editor for script editing and creation (Figure 2.6). It is easier to edit task- 



/*******************************★*********************************** 


Description ; 


Sample script of two M-1 tanks 


Host Id Number: 


501 




Simulator ; 


NPSNET on IRIS VGX Workstation 


Author: 


Phillip West 


*******************************************************************/ 


SCRI P T_T IME_REFERENCE 


relative 


SCRI P T_LOCATI ON 


79A-DN 




/* Activate clouds with velocity 5.0 km/h, heading 270.0 west */ 


ENVIRONMENT_ACTIVATE 


5010499 


Cloud 270.0 5.0 34536783 1000.0 30.0 


/* Activate two M-1 tanks */ 




VEHICLE_ACTIVATE 


5010001 


Ml 090.0 40.0 345678 0.0 40.0 


VEH I CLE_ACT I VATE 


5010002 


Ml 090.0 40.0 345678 0.0 45.0 


/* Change headings of M- 


-1 tanks 


*/ 


VEHICLE__HEADING 


5010001 


135.0 344955 0.0 2:0.0 


VEHICLE_HEADING 


5010002 


120.0 345958 0.0 2:5.0 


/* M-1 tanks passing by 


a palm tree */ 


OBJECT_ACTIVATE 


5010003 


PalmTree 345700 0 4:0.0 


OBJECT_DEACTIVATE 


5010003 


5:35.0 


/* Change velocities of 


M-1 tanks */ 


VEHICLE_SPEED 


5010001 


5.0 344801 0.0 6:0.0 


VEHICLE_SPEED 


5010001 


5.0 344803 0.0 7:25.0 


/* M-1 tanks passing by 


a building */ 


OBJECT__ACTIVATE 


5010004 


Building 345700 0.0 8:10.0 


OBJECTJDEACTIVATE 


5010004 


9:40.0 


/* Deactivate M 1 tanks 


*/ 




VEHICLE_DEACTIVATE 


5010001 


9:45.0 


VEHICLE_DEACTIVATE 


5010002 


9:50.0 


/* Deactivate clouds */ 






ENVI RONMENT^ACTI VATE 


5010499 


10:0.0 


/* End Of Script */ 







Figure 2.6 Sample Script 
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level behaviors of 3D icons in ASCII text, than it is in binary format. Each script statement 
is required to be on a separate line. Since most text editors are capable of handling lines up 
to 132 columns, there is no reason for a single script statement to not fit all on one line. 
There is no limit on number of lines per script file. 

All script event statements in NPSNET-OASIS contain a procedural operator and the 
required arguments for the procedural operator (Figure 2.7). Procedural operators are 



OBJECT ACTIVATE 


100 tree 79A-DN-123678 0.0 1:00.0 


t 

Procedural 

Operator 


t 

Arguments 



Figure 2.7 General Syntax for Script Statements 



classified into five groups - vehicle, weapon, object, environment, and script. All NPSNET- 
OASIS procedural operators begin with the group name for rapid parsing and simplicity. A 
listing of all script events can be found in Appendix A. 

In the interest of clarity and readability, blank lines and comments are permitted 
between statements. Comments are used to explain or describe the script event. Whenever 
the symbol 7*’ is encountered on a line, all characters from that point on, until the symbol 
is reached, is considered to be a comment. 

Case is not important in procedural operators and required arguments. All characters 
are converted to lower case for parsing and extraction. The only time case is important, is 
when characters in script file names are case sensitive for UNIX based input and output 
disk operations. 
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III. OVERVIEW OF NPSNET-OASIS 



A. SCRIPTING TOOLS 

The NPSNET-OASIS system communicates with three scripting tools - the script 
processor, the script generator, and the timekeeper (Figure 3.1). Each tool is independent of 




Figure 3.1 The NPSNET-OASIS System 
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the other. The integration of the scripting tools, provides animators the required 
mechanisms to record and playback scripts. 

1. Script Processor 

Hidden from the user, all functions of the script processor are accessed from the 
NPSNET-OASIS system. Functions include reading script objects and assigning script files 
to process. There is only one script file active in the script processor at any given instance. 
However, multiple processors are allowed. On end of file, the script processor can be 
assigned another script file from the NPSNET-OASIS system. 

The script processor returns a script result after each read. Script results are based on 
valid script statements or errors reading the script file. File errors are treated as end of 
scripts or invalid script files. When an error occurs for a script statement, a message is 
displayed on the standard output device indicating type of error, followed by line number 
and name of current script file (Figure 3.2). Messages provide users a tool for debugging 
scripts. Description of script results and script errors are contained in Appendix A. 



SCRIPT ERROR: Invalid OASIS Procedural Operator 
[Line 101 of file ‘script.ml ’ ^ ^ 

t T 1 

Line Number Name of Script File Type of Error 



Figure 3.2 Error Message 

Script statements are read in line for line by the script processor. When blank lines are 
encountered, the script processor ignores them, and continues to read the script file. 
Beginning with the symbol 7*’ script comments are continuous script lines containing 
information about script events or script options. The script processor treats each line as a 
comment until the termination symbol “*/’ is reached. The user must be careful in using 
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script comments. A script comment with no termination symbol will include valid script 
events until end of file. Script lines containing script events or script options are valid only 
when both procedural operators and the required arguments are valid. The number of 
arguments for each procedural operator are fixed. Thus, incomplete or extra arguments will 
make the script line invalid. In addition, incomplete format of a required argument will 
preempt an error message by the script processor. 

2. Script Generator 

The script generator’s primary purpose is to write script objects to an output file in 
NPSNET-OASIS script format. Error checking does not exist since script objects contain 
default values for all values not assigned in events. All script files generated from the script 
generator are valid files for script processing. When several script files exist, a library can 
be created by including several script files into one script. There are no specified maximum 
number of lines per script file. The only limitation is the space available on disk. 

3. System Timekeeper 

As timestamps are processed for each script event, the system timekeeper adjusts them 
for simulator interaction. Timestamps for each script event are assumed relative to the start 
time of the input script file. When absolute, timestamps are relative to the start time of 
NPSNET-OASIS system. The timekeeper uses the system clock of the graphics 
workstations for all assignments of start times. Times received from system clocks are 
based on total seconds and total microseconds since January 1, 1970 [Ref. 7j. 

There are two types of clock references - system and user. The difference between the 
two, is that system clock reference is actual system time, and user clock reference is the 
time selected by the user in seconds and microseconds. When selected in user clock 
reference, the user has the option to change the start time for the NPSNET-OASIS system. 
When changed, the timekeeper adjusts the new start time with the system clock. In addition, 
the start times for the input script file and output script file are also changed to the same 
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start time as the NPSNET-OASIS system. When writing script files, timestamps are always 
reference to the start time of the output script file. 

In Figures 3.3 and 3.4, timestamp adjustments are illustrated for system clock 
reference and user clock reference. The timestamp is converted to total seconds and total 



System Start Time 
00:00:00 Sept 1, 1991 


Total Secs 


Usees 


683697600 


500000 



Timestamp of 10:01:05.5 


Total Secs 


Usees 


665 


500000 



Input Script Start Time 
00:00:10 Sept 1, 1991 


Total Secs 


Usees 


683697610 


100000 



Timestamp of 10:01:05.5 


Total Secs 


Usees 


665 


500000 



Timestamp in Relative 


Total Secs 


Usees 


683698266 


0 



Timestamp in Absolute 


Total Secs 


Usees 


683698275 


600000 



Figure 3.3 Illustration of Timestamp Adjustment Based on System Clock 



Timestamp of 10:01:05.5 


Total Secs 


Usees 


665 


500000 



Timestamp of 10:01:05.5 


Total Secs 


Usees 


665 


500000 



System Start Time 


Total Secs 


Usees 


0 


0 



Input Script Start Time 


Total Secs 


Usees 


9 


600000 



Timestamp in Relative 


Total Secs 


Usees 


665 


500000 



Timestamp in Absolute 


Total Secs 


Usees 


675 


100000 



Figure 3.4 Illustration of Timestamp Adjustment Based on User Clock 
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microseconds. The total seconds and microseconds are used for timestamp adjustments 
based on either relative or absolute time reference. In relative time reference with the 
system clock, the timestamp is added to the start time of the input script file. In absolute 
time reference, the timestamp is added to the start time of the NPSNET-OASIS system. The 
same procedure is also applied to the user clock reference. 



Each script event has a 3D icon identification, a position, a timestamp and attributes 
to describe a task-level behavior event. Users of NPSNET-OASIS must be familiar with 
the data structures and the information contained in them. 

1. 3D Icon Identification 

3D icon identifications include an object number, a host number, an object description, 
and an object status. Object numbers are four digit values assigned to 3D icons by the visual 
simulator to distinguish from other 3D icons. Host numbers are three digit values used in 
identifying visual simulators in a network. When combined, a host number and an object 
number provide an unique identification number to a 3D icon (Figure 3.5). Object 
descriptions are descriptive names of 3D icons. NPSNET requires them for associating 
OFF files for visual display. Supplementing world state information, object status is a 
description of the current state on a 3D icon. 



B, STRUCTURE OF SCRIPT EVENTS 






Object Identification 
Number 



Figure 3.5 The 3D Icon Identification Number 
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2. Event Position 



Positions for a script event include grid coordinates and an elevation. Elevation, 
represented in meters, is the altitude of an area above sea level. The primary military grid 
reference system in the United States, the Universal Transverse Mercator (UTM), is a 
world wide plane coordinate system based on the metric standard [Ref. 4]. The grid 
coordinate system of UTM is adopted in NPSNET-OASIS (Figure 3.6). Each UTM grid 
zone is a square area of six degrees in longitude by eight degrees in latitude. UTM 
coordinates are designated by two or three characters. The last character, in alphabetic 
notation, represents the latitude offset, and the beginning characters, in numeric notation, 
represents the longitude offset. To further identify locations in each UTM grid zone, the 
U.S. Army created the MGRS [Ref. 4]. MGRS subdivides UTM grid zones into 100,000 
meter square areas designated by two letters. To complete the MGRS grid, UTM easting 
and northing are used to designate which square meter area. Coordinates are in even digits 
where the first half representing easting, and the second half, northing. Precision in UTM 
coordinates requires five digits for easting and northing. In NPSNET-OASIS, easting and 
northing coordinates with digits less than five, are appended with additional zeros (Figure 



3.7). 




Gridzone MGRS Easting Northing 



Figure 3.6 UTM Coordinate Position 
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Figure 3.7 UTM Coordinate Position With Padded Zeros 



3. Timestamp 

Timestamps are based upon the 24-hour clock metaphor where times are represented 
as strings [Ref. 1]. Each field of the timestamp string is represented by numeric characters 
with leading zeros being optional. In Figures 3.8a-c, hours, minutes, and seconds of the 
timestamp string are interpreted from right to left. Microseconds are interpreted from left 
to right (Figure 3.8). Used in event scheduling, timestamps indicate when to execute the 
event. In time delays, timestamps indicate the time durations of the script pauses, or the 
time to begin reading scripts. In Figure 3.8, timestamps are listed in fomiats acceptable to 
NPSNET-OASIS. 

4. Event Attributes 

Representing properties of continuous and transient events, attributes provide 
additional information on script events. Attributes enable a 3D icon to be unique among 
other 3D icons in simulation. Information such as headings and velocities of 3D icons are 
affected by state changes of continuous events. Appearances of 3D icons are affected by 
state changes of transient events. An example of a transient event is an explosion of a 3D 
icon. The attributes for this event require the description type and the bounding area of the 
explosion. See Appendix I for description of event attributes. 
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Figure 3.8 Timestamp Formats 



C. SCRIPT OPTIONS 

Script options, or directives, are used in script files for file operations, script system 
defaults, and assigning values for timestamp adjustments. From Figure 2.6, the script is 
modified to include all the script options available to NPSNET-OASIS (Figures 3.9 and 
3.10). Syntax for each script option is listed in Appendix A. 

1. Script_Abort 

Normal termination of NPSNET-OASIS requires all statements in the input script file 
to be processed. However, the animator has the option to terminate the script by inserting 
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^'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'kit'k'k'k'kic'k'k'k'k'k'k'k'kic'kic'k'k'k'k'kic'kic'k'k 



Description : 

Host Id Number: 
Simulator : 

Author: 

************************ 



Sample script of two M-1 tanks 'script. ml' 
501 

NPSNET on IRIS VGX Workstation 
Phillip West 

******************************************** 



/ 



/* Assign timestaic^ reference relative to start time of input script */ 
SCRIPT_TIMESTAMP relative 

/* Assign default UTM gridzone and MGRS */ 

SCRIPT_LOCATION IIS-DN 

/* Assign time factor of 50 percent for all timestamps */ 

SCRIPT TIME FACTOR 0.5 



/* Assign time adjustment value of 10 seconds for all timestan^s */ 
SCRIPT TIME ADJUSTMENT 10.0 



/* Activate clouds with velocity 5.0 km/h, heading 270.0 west */ 
ENVIRONMENT ACTIVATE 5010500 Cloud 270.0 5.0 34536783 1000.0 30.0 



/* Activate two M-1 tanks */ 

VEHICLE_ACTIVATE 5010001 Ml 090.0 40.0 344955 0.0 40.0 

VEHICLE ACTIVATE 5010002 Ml 090.0 40.0 345958 0.0 45.0 



/* Change headings of M-1 tanks 
VEHICLE_HEADING 5010001 
VEHICLE HEADING 5010002 



*/ 

135.0 344801 0.0 2:0.0 

120.0 344803 0.0 2:5.0 



/* Change velocities 
VEHICLE_SPEED 
VEHICLE SPEED 



of M-1 tanks */ 

5010001 5.0 344670 0.0 6:0.0 
5010001 5.0 344677 0.0 7:25.0 



/* M-1 tanks passing by a building */ 

OBJECT_ACTIVATE 5010004 Building 344701 0.0 8:10.0 

OBJECT DEACTIVATE 5010004 9:40.0 



/* Script message for advance warning of upcoming script events */ 
SCRIPT_MESSAGE Activating column of jeeps 

/* Script call for column of jeeps */ 

SCRIPT_CALL script-2. ml 

/* Continue script with next script file */ 

SCRIPT_CHAIN script -1 .ml 



Figure 3.9 Sample Script With Script Options 
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Description: 


Sample script of two M-1 tanks 'script-1 .ml' 


Host Id Number: 


501 


Simulator : 


NPSNET on IRIS VGX Workstation 


Author : 


Phillip West 




/* M-1 tanks passing by 


a palm tree */ 


OBJECT_ACTIVATE 


5010003 PalmTree 345700 0.0 22:0.0 


OBJECTJDEACTIVATE 


5010003 22:35.0 


/* Change velocities of 


M-1 tanks */ 


VEHICLE_SPEED 


5010001 5.0 345670 0.0 26:0.0 


VEHICLE_SPEED 


5010001 5.0 345677 0.0 27:25.0 


/* Deactivate M 1 tanks 


*/ 


VEHICLEJDEACTIVATE 


5010001 29:45.0 


VEHICLE_DEACTIVATE 


5010002 29:50.0 


/* Deactivate clouds */ 




ENVIRONMENT_ACTIVATE 


5010500 30:0.0 


/* Script delay for duration of 5 minutes prior to termination */ 


SCRIP TJDELAY 


5:0.0 absolute 


/* Write to output script file message for next script processing */ 


SCRI P T_FI LE_WRI TE 


SCRIPT^MESSAGE End of Script 


/* Terminate script */ 




SCRIPT_ABORT 






Description : 


Sample script of multiple jeeps 'script-2 .ml' 


Host Id Number: 


501 


Simulator: 


NPSNET on IRIS VGX Workstation 


Author : 


Phillip West 


********************************************************************/ 


/* Activate jeep vehicle */ 


VEHI CLE_ACT I VATE 


5010010 Jeep 090.0 40.0 345678 0.0 10:0.0 


/* Repeat script for 10 


iterations with total 11 separate vehicles */ 


SCRIPT_REPEAT 


10 1 1:0.0 



Figure 3.10 Sample Script With Script Options 
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SCRIPT_ABORT. This script directive has no arguments. When encountered, all script 
files are closed, and a script result of END_OF_SCRIPT is returned to the system. 

2. Script Call 

The directive SCRIPT_CALL is a subscript call, similar to a procedure call in a high- 
level programming language. The argument for this directive is a string containing the 
script file name. The calling script file is suspended during processing of the subscript and 
control returns on subscript’s end of file. This directive supports modular scripting in 
NPSNET-OASIS. 

3. Script_Chain 

Linking of one input script file to another requires the script directive 
SCRIPT_CHAIN. The required argument is a string containing the script file name. After 
the chained script file is successfully opened, the other script file is closed. This directive 
is useful for combining small script files into one large script. 

4. Script Repeat 

Similar to a counter-controlled loop, the script directive SCRIPT_REPEAT allows 
scripts to be processed repeatedly. There are three arguments for SCRIPT_REPEAT - 
iterations, object number adjustment, and timestamp adjustment. Iterations are values for 
the number of times repeating the same script. Object number adjustment is the increment/ 
decrement value for all 3D icon identification numbers. Similar to the script option 
SCRIPT_TIME_ADJUSTMENT, timestamp adjustment is the increment/decrement of 
timestamps for each repeated script event. All script events in script chains and script calls 
are affected by SCRIPT_REPEAT. This directive is useful for repeating the entire script, 
or repeating a short series of script events. 

5. Script_Timestamp 

SCRIPT_TIMESTAMP, with the selected string as argument, is used to change time 
reference in script processing. The default time reference for NPSNET-OASIS system is 
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“relative”. The other option is “absolute”.Relative time reference is for all timestamp' 
adjustments based on input script start time. Absolute time reference is for all timestamp 
adjustments based on system start time. 

6. Script_Time_Adjustment 

Changing event timestamps throughout the script requires 
SCRIPT_TIME_ADJUSTMENT to be inserted prior to selected statements. An argument 
in timestamp format, is used for adding to event timestamps. To stop timestamp 
adjustments, requires another SCRIPT_TIME_ADJUSTMENT and an argument of zero. 

7. Script_Time_Factor 

Another option for adjusting timestamp, is the use of SCRIPT_T1ME_FACT0R. 
With a floating-type numeric argument, SCRIPT_TIME_FACTOR, provides the time 
factor percentage for each event timestamp. This option is useful for incrementing or 
decrementing speed of script processing. For example, the value of 2.0 causes two seconds 
of script time to be four seconds of wall clock time. 

8. Script_DeIay 

There are two arguments required for SCR1PT_DELAY - timestamp and delay type. 
Delay type is either “absolute” or “relative”. In absolute mode, the current script is 
suspended until the time specified by the timestamp. In relative mode, the current script is 
suspended for the time duration specified by the timestamp. 

9. Script_Location 

Upon initialization, the NPSNET-OASIS system assigns the default UTM gridzone 
and MGRS with strings “lOS” and “DN” respectfully. Defaults will be assigned when an 
UTM gridzone and/or MGRS are not included in the event position. Replacing one or both 
system defaults requires SCRIPT_LOCATION to be used in the script. 



22 



10. Script_File_Write 

Script objects recorded to an output script file include script events and script 
comments. There are no script options or blank lines. SCR1PT_FILE_WRITE provides 
animators the capability to include any type of script statements in a recorded script. If there 
is no output script file, then an error message is displayed. 

11. Script Message 

While developing software, programmers include statements in their source code for 
tracing and debugging. In NPSNET-OASIS, animators have the same capability by 
allowing script messages to be displayed on a standard output device. Messages can include 
any text desired by the animator. One suggestion is to use script messages prior to selected 
script events. Messages with information on upcoming events provide advanced warning 
of what to expect in visual simulation. 
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IV. IMPLEMENTATION OF NPSNET-OASIS 



A. OVERVIEW 

The current NPSNET system runs across the entire Silicon Graphics, Inc. (SGI) IRIS 
4D line [Ref. 10]. NPSNET-OASIS was developed with no graphics function calls, thus 
allowing application on various types of platforms including non-graphics workstations. 
Networking allows the different platforms to interact on other workstations in the 
Graphics and Video Laboratory. 

For autonomous vehicle control, the network harness process of NPSNET enables 
NPSNET-OASIS to provide scripted autonomous players in visual simulation [Ref. 10]. 
The network harness uses Ethernet TCP/IP multicast packets designed for the NPSNET 
system. The purpose of this process is to listen to the packets broadcast on the network and 
to build an internal model of the state of the world from those packets. Script events from 
NPSNET-OASIS are transformed to message packets and broadcasted via the network 
harness. In addition, packets received are transformed and recorded to an output script. 

B. DATA STRUCTURES 

The data structures required for the script event and message packet transformations 
are contained in Appendices I through K. Currently in NPSNET, only vehicle script 
events are used for autonomous vehicle control. As further development of NPSNET 
continues, other script events are integrated to allow enhanced modeling of the world. 

C. NPSNET-OASIS NETWORK INTERFACE 

As shown in Figure 4.1, NPSNET-OASIS is integrated into NPSNET by coupling 
with the NPSNET-OASIS network interface. The network interface provides the 
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Figure 4.1 NPSNET-OASIS Network Interface 



synchronization in playbacks and recordings of NPSNET-OASIS scripts. Using the 
required data structures, transformations of all script event message packets are processed 
in the network interface. 

1. Internal Data Structures 

Several NPSNET-OASIS network interfaces can interact with NPSNET with each 
containing its own internal data structures for representing the state of the world. Referred 
to as the local state of the world, the data structure contains all locations and vehicle types 
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for NPSNET-OASIS. Additionally, another internal data structure is used for indicating 
which vehicle icons are recorded on script. First time script events of vehicle icons 
require the script event VEH1CLE_ACTIVATE to be recorded on script. Playback of 
scripts requires VEHICLE_ACTIVATE to set the vehicle attribute alive for the vehicle 
icon to be active in NPSNET. The network interface updates the local data structures prior 
to each message broadcast and prior to recording on script. 

2. Message Packets 

Currendy there is only one type of message packet used in NPSNET for scripted 
autonomous players - vehicle update. Each vehicle script event is processed as a vehicle 
update regardless of event type. The encoding of the message packet is described in 
Appendix K. 

There are three types of message packets received from the network - stop script, 
time synchronization, and vehicle update. Stop script message enables the NPSNET- 
OASIS network interface to detach from the network. Time synchronization message 
assigns the initial start time of NPSNET. NPSNET-OASIS sets all start times of script 
fdes and script system to the time specified in the message. Vehicle update message is 
used to update the local state of the world and to record the script event. 

3. Operation of Network Interface 

Referring to Figure 4.2, the NPSNET-OASIS network interface is operational until 
end of input script file or a stop script message packet. If the network interface was 
initialized with no input script file, then a stop script message is required. Prior to reading 
script events, the network is checked for incoming message packets. When message 
packets exist, the local state of the world is updated and the transformed script events are 
recorded. All script events from the input script file are transformed to message packets 
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and sent to the network. System time for NPSNET-OASIS is based on the user clock 
reference. 
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void MonitorNpsnetNetworkQ { 



AddProcessToNetworkO; 

SetSystemStartTime(StartTicks / HZ, StartTicks % HZ); 

while(ActiveNetworklnterface) { 

CurrentTicks = (times(&SysTimes) - StartTicks); 

ReceiveAndProcessMessagesO; 

if(InputScriptExists && ActiveNetworkInterface) { 

ReadAndProcessScriptEvent(CurrentTicks, VehicleArray); 

switch(GetScriptResultO) ( 
case END_OF_SCRIPT: 

InputScriptExists = FALSE; 
if(!OutputScriptExists) 

ActiveNetworkInterface = FALSE; 
break; 

case SCRIPT_VALID; 

WriteScriptMessage(GetIconID(), GetEventID()); 

SendUpdateMessage(GetIconID()); 

break; 

case SCRIPT_ERROR: 
case SCRIPT_IN_DELAY: 
case NO_SCRIPT_EVENT; 
default: 
break; 

) // end switch 

} // endif 

) // endloop 

DetachProcessFromNetworkQ; 

// end MonitorNpsnetNetwork 



Figure 4.2 Network Interface Monitor Routine 
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V. CONCLUSIONS AND RECOMMENDATIONS 



A. SUMMARY AND CONCLUSION 

The NPSNET-OASIS system has fulfilled the initial requirement of providing tools to 
record and playback scripts. The NPSNET-OASIS network interface provides users of 
NPSNET the capability to generate scripted autonomous players in visual simulations. 
The study in applying object-oriented methodologies in a practical design such as 
NPSNET-OASIS was beneficial for extensibility and reusability of existing source code. 
This was proven when the network interface for NPSNET-OASIS was built on top of a 
script system. As new software developments evolve in the Graphics and Video 
Laboratory, changes can be made in NPSNET-OASIS with little modifications. 

B. LIMITATIONS 

There are two limitations in NPSNET-OASIS. First, using the classes of NPSNET- 
OASIS requires C-)--)- throughout software development. Existing software in the Graphics 
and Video Laboratory such as NPSNET must be converted to C-i-t- in order to fully 
integrate NPSNET-OASIS in code. The second limitation is that NPSNET is currently 
unable to use all the script events in NPSNET-OASIS. The data structures for NPSNET 
are limited in containing the information for all types of continuous and transient events. 
In addition, the capabilities for transient events such as collisions and explosions are still 
under development. Current design of the NPSNET-OASIS network interface permits only 
continuous events of vehicle icons, such as vehicle heading and velocity changes. 

C. FUTURE DIRECTIONS 

Current implementations of NPSNET-OASIS are in executable load modules with no 
graphics functions. Execution of load module requires typing the module name at the 
command prompt. There are no output displays other than error messages generated during 
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processing and recording of scripts. Future effort could be placed on developing some 
interactive tool for using the script tools of NFS NET-OASIS, such as a graphics script 
editor or a syntax directed editor. 

The NPSNET-OASIS network interface is implemented only for the SGI IRIS 
graphics workstations. Porting the software to other platforms should be an easy matter. 
Suggestion is to modify the source code of NPSNET-OASIS for providing scripted 
autonomous players from a different platform. 
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APPENDIX A 

NPSNET-OASIS Script Events, Results, and Errors 



Note: Back slashes ’V in syntax or examples indicate continuation on the same line. 



Vehicle Events 



VEHICLE_ACTIVATE 

VEHICLE__ACTIVATE <vehlcle number> <type description> <headlng> \ 

<veloclty> <UTM coordd nates> <elevatlon> \ 
<timestamp> 



Description - New vehicle icon activated for visual simulation. 

Example- VEHICLE_ACTIVATE 200 mi 235.0 5.0 1234567890 0.0 5:0.0 



VEH I CLE_DEACT I VATE 

VEHICLE_DEACTIVATE <vehlcle number> <timestamp> 

Description - Vehicle icon deactivated from visual simulation. 
Example- vehiclejdeactivate 200 5: 0.0 



VEHICLE_MODIFICATION 

VEHICLE^MODIFICATION <vehicle number> <component name> \ 

<rotatlon X direction> \ 

<rotation Y direction> <rotation Z direction> \ 
<translation X dlrectlon> 

<translation Y directlon> \ 

<translatlon Z dlrectlon> <UTM coordlnates> \ 
<elevation> <timestamp> 

Description - Vehicle icon is modified by changing the degrees of freedom on one of it’s 
components. 
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Example- vehicle_modification 200 turret lO.O lo.o lo.o 25.0 25 . 0\ 
25.0 1234567890 0 . 05 : 0.0 



VEHICLE_PITCH 

VEHICLE_PITCH <vehlcle nurnber> <pitch angle> <UTM coordlnates>\ 

<elevation> <timestamp> 



Description - Pitch angle of vehicle icon is changed. Negative values indicated downward 
angle and positive values indicate upward angle. 

Example- VEHICLE_PITCH 200 10.0 1234567890 0.0 5:0.0 



VEHICLE_ROLL 

VEHICLE_ROLL <vehicle number > <roll angle> <roll direction> \ 

<UTM coordlnates> <elevatlon> <timestamp> 



Description - Roll angle of vehicle icon is changed. The direction of the roll is either 
’stbd’, ’port’, or ’none’. Direction ’none’ indicates a roll angle of 0.0. 

Examples- VEHICLE_R0LL 200 10.0 stbd 1234567890 0.0 5:0.0 

VEHICLE_ROLL 200 10.0 port 1234567890 0.0 5:0.0 

VEHICLE_ROLL 200 0.0 none 1234567890 0.0 5:0.0 

VEH I CLE_P OS I T I ON 

VEHICLE_POSITION <vehicle number> <UTM coordinates> <elevation> \ 

<tlmestamp> 

Description - The position of vehicle icon is updated. 

Examples- VEHICLE_P0SITI0N 200 79A-DN-1234567890 0.0 5:0.0 
VEHICLE_POSITION 200 79A-1234567890 0.0 5:0.0 
VEHICLE POSITION 200 DN-1234567 890 0.0 5:0.0 
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VEHICLE HEADING 



VEHICLE^HEADING <vehicle number> <heading> <UTM coordinates> \ 

<elevation> <timestamp> 



Description - The heading of vehicle icon is changed. All headings are from 0.0 to 359.9 
degrees relative to North. For NPSNET, degrees are required to be in radians. 

Example - VEHICLE_HEADING 200 2 IQ. 0 79A-DN-1234567890 0.0 5:0.0 



VEHICLE_SPEED 

VEHICLE_SPEED <vehicle number> <velocity> <UTM coordinates > \ 

<elevation> <timestamp> 

Description - The velocity of vehicle icon is changed. All velocities are in kilometers per 
hour. 

Example- VEHICLE_SPEED 200 10.0 79A-DN-1234567890 0,0 5:0,0 



VEHICLE_TRAIL 

VEHICLE_TRAIL <vehlcle number > <trall description> \ 

<bound area X direction> \ 

<bound area Y direction>\ 

<bound area Y directi on> <offset X direction> \ 
<offset Y direction> <offset Z direction> \ 

<UTM coordinates> <elevation> <timestamp> 



Description - The trail of vehicle icon is activated for visual simulation. Trails such as dust 

or wake requires attributes for bounding area for size and vehicle offset. 

Example - VEHICLEJTRAIL 200 medi umdust 10.0 10.0 10.0 0.0 0.0 0.0\ 
1234567890 0.0 5:0.0 

VEHICLE__COLLI S ION 

VEHICLE^COLLISION <vehicle number > <description result > \ 

<UTM coordinates> <elevation> <timestamp> 
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Description - This event is a transient event indicating vehicle icon collision with another 
icon. 

Example - VEHICLE_C0LLISI0N 200 destroyed 79A-DN-1234567890 0.0 5:0.0 



VEH I C LE_EXP LOS I ON 

VEHICLE^EXPLOSION <vehicle number> <explosion description> \ 

<bound area X dlrectlon> \ 

<hound area Y direction> \ 

<hound area Y direction> <VTM coordinates> \ 
<elevation> <tlmestamp> 

Description - This event is a transient event of a vehicle icon explosion. Attributes 
required are explosion type and bounding area for explosion. 

Example- VEHICLE_EXPL0SI0N 200 largescale 10.0 10.0 10.0 1234567890\ 
0. 0 5:0. 0 

VEHICLE_FLAMING 

VEHICLE_FLAMING <vehlcle number> <description of fire> \ 

<bound area X direction> \ 

<bound area Y direction>\ 

<bound area Y direction> <offset X dlrection> \ 
<offset Y dlrectlon> <offset Z dlrection> \ 

<UTM coordinates> <elevation> <timestamp> 



Description - This event is a transient event of a vehicle icon on fire. Attributes required 

are type of flames, bounding area of the flames, and the vehicle offset to the flames. 

Example- VEHICLE_FLAMING 200 mediumflame 10.0 10.0 10.0 0.0 0.0 0.0\ 
1234567890 0. 0 5:0. 0 



VEHICLE_SMOKING 

VEHICLE_SMOKING <vehicle number> <description of smoke> \ 

<bound area X direction> \ 

<bound area Y dlrectlon> \ 

<bound area Y directlon> <offset X direction> \ 
<offset Y direction> <offset Z direction> \ 

<UTM coordlnates> <elevatlon> <timestamp> 
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Description - This event is a transient event of a vehicle icon emitting smoke. Attributes 

required are smoke type, bounding area of the smoke, and the vehicle offset to the smoke. 

Example- VEHICLE_SM0KING 200 mediumsmoke 10.0 10.0 10.0 0.0 0.0 0.0\ 
1234567890 0.0 5:0. 0 

VEH I CLE_DESTROYED 

VEHICLE_DESTROYED <vehicle number> <UTM coordinates> <elevation> \ 

<tlmestamp> 

Description - Not removed from visual simulation, the vehicle icon is destroyed. 
Example- VEHICLE_DESTR0YED 1234567890 O.O 5:0.0 

VEHICLE_FUEL 

VEHICLE^FUEL <vehlcle number> <fuel amount > <timestamp> 

Description - The fuel state is changed on a vehicle icon. Amount of fuel left in vehicle 
icon is indicated in liters. 

Example - vehicle_fuel 200 lO.O 5:0.0 

VEHICLE_AMMUNITION 

VEHICLE_AMMUNITION <vehicle number> <weapon name> <weapon rounds> \ 

<timestamp> 

Description - The ammunition state is changed on a vehicle icon. Weapon rounds of 
weapon name indicate current number assigned to the vehicle icon. 

Example- VEHICLE_AMMUNITI0N 200 turret 10 5: 0.0 



VEHI CLE_UPDATE 

VEHICLE_UPDATE <vehicle number> <vehicle status> <heading> \ 

<veloclty> <pitch angle> <roll angle> \ 

<roll direction> <UTM coordinates> <elevation> \ 
<timestamp> 
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Description - Update status on a vehicle icon. 

Examples- VEHICLE_UPDATE 200 inmotion 260.0 10.0.0 0.0 none 456789\ 
0. 0 5:0. 0 

VEHI CLE_STATUS_QUERY 

VEHICLE_STATUS_QUERY <vehicle number> <timestamp> 

Description - This event queries status of a selected vehicle icon. 

Example- vehicle_status_query 200 5: 0.0 



Weapon Events 



WEAPON_LAUNCH 

WEAPON^LAUNCH <weapon number> <source ld> <descrlptlon>\ 

<heading> <headlng type> <velocity> \ 

<pltch angle> <UTM coordlnates> <elevatlon> \ 
<timestamp> 

Description - Weapon is launch from a source vehicle icon with initial velocity and 
headings. Headings are indicated in relative ’R’ or absolute ’A’. 

Examples- WEAP0N_LAUNCH 300 200 sm-2 260.0 a 500.9 45.0 456789 3.0\ 
5:0.0 

WEAPON_LAUNCH 300 200 sm-2 260.0 R 500.9 45.0 456789 3.0\ 
5:0. 0 



WEAPON_IMPACT 

WEAPON_IMPACT <weapon number> <source id> <UTM coordinates>\ 

<elevation> <tlmestamp> 

Description - Weapon impact terminating weapon icon. 

Example- WEAP0N_IMPACT 300 200 456789 3.0 5: 0.0 
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WEAPON EXPLOSION 



WEAPON_EXPLOSION <weapon number> <source id> <UTM coordinates> \ 

<elevation> <tlmestamp> 

Description - Weapon explosion terminating weapon icon. 

Example- WEAP0N_EXPL0SI0N 300 200 456789 3.0 5:0.0 



WEAPON_DPDATE 

WEAPON^UPDATE <weapon number > <source ld> <weapon status> \ 

<headlng> <heading type> <veloclty> \ 

<pitch angle> <UTM coordlnates> <elevatlon> \ 
<timestamp> 

Description - Update status on a weapon icon. 

Examples- WEAP0N_UPDATE 300 200 active 26 O.O a 300.0 35.0 456789 3.0 5:0.0 
WEAPON UPDATE 300 200 active 260.0 R 300.0 35.0 456789 3.0 5:0.0 



WEAPON_STATUS_QUERY 

WEAPON^STATUS^QUERY Kweapon number > <source ld> <timestamp> 

Description - This event queries status of a selected weapon icon. 

Examples- weapon_status_query 300 200 5: 0.0 



Miscellaneous Object Events 

OBJECT_ACTIVATE 

OBJECT^ACTIVATE <object number> <object description> \ 

<UTM coordlnates> <elevation> <timestamp> 

Description - New miscellaneous object icon activated for visual simulation. 
Example- 0BJECT_ACTIVATE 250 building 1234567890 5:0.0 
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OBJECT_DEACTIVATE 

OBJECT_DEACTIVATE <object number> <timestamp> 

Description - Miscellaneous object icon deactivated from visual simulation. 
Example- object_deactivate 250 5:0.0 



OB JECT_COLLI SON 

OBJECT_COLLISION <object number> <description result >\ 

<UTM coordlnates> <elevation> <timestamp> 



Description -This event is a transient event indicating miscellanious object icon collision with 
another icon. 

Example - 0BJECT_C0LLISI0N 250 destroyed 79A-DN-1234567890 0.0 5:0.0 



OBJECT_EXPLOSION 

OBJECT__EXPLOSION <object number> <explosion description> \ 

<bound area X dlrectlon> \ 

<bound area Y dlrection> \ 

<bound area Y direction> <UTM coordlnates> \ 
<elevatlon> <tlmestamp> 

Description - This event is a transient event of a miscellaneous object icon explosion. 
Attributes required are explosion type and bounding area for explosion. 

Example- 0BJECT_EXPL0SI0N 250 largescale 10.0 10.0 10.0 12345678 0.0 5:0.0 

OBJECT_FLAMING 

OBJECT__FLAMING <object number > <description of fire> \ 

<bound area X dlrection> \ 

<bound area Y direction> \ 

<bound area Y directlon> <offset X direction> \ 
<offset Y direction> <offset Z direction> \ 

<UTM coordlnates> <elevation> <timestamp> 
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Description - This event is a transient event of a miscellaneous object icon in flames. 
Attributes required are flame type, bounding area of the smoke, and the object offset of the 
flames. 

Example- 0BJECT_FLAMING 250 largescale 10.0 10.0 10.0 0.0 0.0 0.0\ 
1234567690 0.0 5:0.0 



OBJECT_SMOKING 

OBJECT_SMOKJNG <object number> <description of smoke> \ 

<bound area X direction> \ 

<bound area Y direction> \ 

<bound area Y direction> <offset X direction> \ 
<offset Y direction> <offset Z direction> \ 

<UTM coordinates> <elevation> <timeszarrp> 

Description - This event is a transient event of a miscellaneous object icon emitting smoke. 
Attributes required are smoke type, bounding area of the smoke, and the object offset of the 
smoke. 

Example- 0BJECT_SM0KING 250 mediumsmoke 10.0 10.0 10.0 0.0 0.0 0.0\ 
1234567890 0.0 5:0.0 



OBJECT_UPDATE 

OBJECT_UPDATE <object number> <object status> \ 

<UTM coordinates> <elevation> <timestamp> 



Description - This event queries status of a selected miscellaneous object icon. 
Examples- 0BJECT_UPDATE 250 active 1234567890 0.0 5:0.0 

OBJECT_STATUS_QUERY 

OBJECT_STATUS_QUERY <object number> <timestamp> 

Description - This event queries status of a selected miscellenous object icon. 
Example- object_status_query 250 5:0.0 
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Environment Events 



ENVI RONMENT_ACT I VATE 

ENVIRONMENT^ACTIVATE <envlronment object number > <type descrlption> \ 

<heading> <veloclty> <UTM coordinates> \ 
<elevation> <timestamp> 

Description - New environment effect icon is activated for visual simulation. 

Example* ENVIR0NMENT_ACTIVATE 400 cloud 345.0 5.0 1234567890 5: 0.0 



ENVI RONMENT_DEACT I VATE 

ENVIRONMENT^DEACTIVATE <envl ronment object number> <tlmestamp> 

Description - Environment effect icon of vehicle number is deactivated from visual 
simulation. 

Example- environment_deactivate 4 00 5: 0.0 



Script Options 

SCRIPT_ABORT 

SCRIPT_ABORT 

Description - Normal termination of NPSNET-OASIS requires all statements in the input 
script file to be processed. However, the animator has the option to terminate the script by 
inserting SCRIPT_ABORT. This script directive has no arguments. When encountered, all 
script files are closed, and a script result of END_OF_SCRIPT is returned to the system. 
Example - script_abort 

SCRIPT_CALL 

SCRIPT_CALL <filename for script call> 

Description - The directive SCRIPT_CALL is a subscript call, similar to a procedure call 
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in a high-level programming language. The argument for this directive is a string 
containing the script file name. The calling script file is suspended during processing of the 
subscript. Only one script is processed at any given time. Script file control returns to the 
caller on subscript’s end of file. This directive supports modular scripting in NPSNET- 
OASIS. 

Example - SCRIPTjCALL script-l .mi 



SCRIPT_CHAIN 

SCRIPT_CHAIN <filename for script chaining> 

Description - Linking of one input script file to another requires the script directive 
SCRIPT_CHA1N. The required argument is a string containing the script file name. After 
the chained script file is successfully opened, the other script file is closed. This directive 
is useful for combining small script files into one large script. 

Example - script_chain script-i .mi 



SCRIPT_REPEAT 

SCRIPT_REPEAT <iterations> <object number adjustment> \ 

<time adjustment> 

Similar to a counter-controlled loop, the script directive SCRIPT_REPEAT allows scripts 
to be processed repeatedly. There are three arguments for SCRIPT_REPEAT - iterations, 
object number adjustment, and timestamp adjustment. Iterations are values for the number 
of times repeating the same script. Object number adjustment is the increment/decrement 
value for all 3D icon identification numbers. Similar to the script option 
SCRIPT_TIME_ADJUSTMENT, timestamp adjustment is the increment/decrement of 
timestamps for each repeated script event. All script events in script chains and script calls 
are affected by SCRIPT_REPEAT. This directive is useful for repeating the entire script, 
or repeating a short series of script events. 



41 



Example - SCRIP r_REP£Ar lo i 2:0.o 

SCRIP T_LOCAT I ON 

SCRIPT_LOCATION <new default UTM gridzone and/or MGRS> 

Description - Upon initialization, the NPSNET-OASIS system assigns the default UTM gridzone 
and MGRS with strings “lOS” and “DN” respectfully. Defaults will be assigned when an UTM 
gridzone and/or MGRS are not included in the event position. Replacing one or both system 
defaults, requires SCRIPT_LOCATION to be used in the script. 

Examples - script_location 79a-dn 

SCRIPT_LOCATION 79A 
SCRIPT_LOCATION DN 

SCRI PT_TIMESTAMP 

SCRIPT_TIMESTAMP <time reference for script timestamps> 

Description - The default time reference for NPSNET-OASIS system is “relative”. The other 
option is “absolute”. SCRIPT_TIMESTAMP, with the selected string as argument, is used to 
change time reference in script processing. Relative time reference is for all timestamp adjustments 
based on input script start time. Absolute time reference is for all timestamp adjustments based on 
system start time. 

Examples - SCRIPT_TIMESTAMP relative 
SCRIPT_TIMESTAMP absolute 

SCRI P T_TIME_F ACTOR 

SCRIPT_TIME_FACTOR <time factor value> 

Description - Another option for adjusting timestamp, is the use of SCRIPT_TEME_FACTOR. 
With a floating-type numeric argument, SCRIPT_TIME_FACTOR, provides the time factor 
percentage for each event timestamp. This option is useful for incrementing or decrementing speed 
of script processing. 
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Example - script_time_f actor o. 5 

SCRIPT_TIME_ADJUSTMENT 

SCRIPT_ TIME_ADJUS TMENT <timestamp> 

Description - Changing event timestamps throughout the script requires 
SCRIPT_TIME_ADJUSTMENT to be inserted prior to selected statements. An argument in 
timestamp format, is used for adding to event timestamps. To stop timestamp adjustments, requires 
another SCRIPT_TIME_ADJUSTMENT and an argument of zero. 

Example - script_ time_adjustment lO: 0.5 

SCRIPT_DELAY 

SCRIPT_DELAY <timestamp> <type of script delay> 

Description - There are two arguments required for SCRIPT_DELAY - timestamp and delay type. 
Delay type is either “absolute” or “relative”. In absolute, the current script is suspended until the 
time specified by the timestamp. In relative, the current script is suspended for the time duration 
specified by the timestamp. 

Examples - SCRIPT_DELAY 10:0.0 relative 
SCRIPT DELAY 25:24.0 absolute 



SCRIPT_FI LEJWRITE 

SCRIPT_FILE_NRITE <script line> 

Description - Script objects recorded to an output script file include script events and script 
comments. There are no script options or blank lines. S CRIPT_FILE_WR1TE provides animators 
the capability to include any type of script statements in a recorded script. If there is no output script 
file, then an error message is displayed. 

Example - SCRIPT_FILE_WRITE SCRIPT_MESSAGE end of script 
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SCRIPT MESSAGE 



SCRIPT_MESSAGE <message> 

Description - While developing software, programmers include statements in their source code for 
tracing and debugging. In NPSNET-OASIS, animators have the same capability by allowing script 
messages to be displayed on a standard output device. Messages can include any text desired by 
the animator. One suggestion is to use script messages prior to selected script events. Messages 
with information on upcoming events provide advanced warning of what to expect in visual 
simulation. 

Example- script_message End of script 
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Script Results 



SCRIPT_ERROR 

SCRIPT_ERROR is returned from NPSNET-OASIS when an input/output file error occurred or a 
script statement is invalid. File errors occur if unable to open or close a file. Invalid script 
statements include invalid syntax for script comments, invalid procedural operators, invalid 
arguments for a procedural operator, and invalid formats for arguments. 

END_OF_SCRIPT 

On end of script, which includes processing of all input script files, a result of END_OF_SCRIPT 
is returned. 

SCRIPT_IN_DEIAY 

SCRIPT_IN_DELAY is returned when processing of script files are suspended. 

SCRIPT_VALID 

For a result of SCRIPT_VAL1D, script statements are of valid syntax. 

NO_S CRI P T_EVENT 

An option for classes built on top of NPSNET-OASIS, NO_SCRIPT_EVENT is returned when' 
script processing is suspended or a script event is not ready for return. Used in the NPSNET- 
OASIS network interface, NO_SCRIPT_EVENT is returned when the script event is not ready for 
multicast. 
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Scrint Errors ’ • 

NPSNET-OASIS can only have one main input script file assigned. If another is assigned then the 
following is displayed: 

SCRIPT ERROR: Only one main script permitted to be open. 

The following message is displayed if the main script file does not exist. Possible errors can 
include file does not exist, or some characters of the file name are of upper case. 

SCRIPT ERROR: Unable to open main script file 'filename' . 

When NPSNET-OASIS is unable to close a script file a message is displayed. 

SCRIPT ERROR: Unable to close 'filename ' . 

There are error messages for invalid file opens for script chaining or script call. In addition, another 
line is displayed informing the line number and file name of the script file containing the script 
option. Messages are as follows: 

SCRIPT ERROR: Unable to open script 'filename' for chaining. 
SCRIPT ERROR: Unable to open script 'filename' for script call. 

Script events to be recorded require an output script file. If the file does not exist, then the 
following error message is displayed: 

SCRIPT ERROR: No output file opened for script generation . 

For recording scripts, the following message is displayed if a procedural operator of a script event 
does not exist. 

SCRIPT ERROR: Invalid event lor script generation. 
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If the script statement is not a script comment or a valid script procedural operator, then the 
following message is displayed; 

SCRIPT ERROR: Invalid OASIS Procedural Operator . 

For a valid script comment, the start symbol ’/*’ and the termination symbol ’*/’ must exist. In 
addition, no nesting of comments are permitted. When the termination symbol is encountered by 
the script processor, the rest of the script line is checked for invalid characters. Messages are as 
follows: 

SCRIPT ERROR: Invalid characters after script comment end symbol. 

SCRIPT ERROR: Encountered another script comment beginning. 

SCRIPT ERROR: Script comment with no end symbol. 

When script statements contain valid procedural operator, chances are that required arguments are 
missing, some arguments are of invalid format, or too many arguments. If this should happen, then 
an error message is displayed followed by another line containing line number and name of input 
script file. There is a separate error message for each procedural operator. Messages are as 
follows: 



SCRIPT 


ERROR: 


In valid 


parameters 


for 


en vl ronmen t_actlvate . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


envlronment_deactlvate 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


vehlcle_ 


activate . 


SCRIPT 


ERROR : 


Invalid 


parameters 


for 


vehlcle_ 


deactivate. 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


vehlcle_ 


modi flcatlon . 


SCRIPT 


ERROR : 


Invalid 


parameters 


for 


vehicle _pltch. 


SCRIPT 


ERROR : 


Invalid 


parameters 


for 


vehlcle_ 


roll. 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


vehl cl e^osl tlon. 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


vehicle 


heading. 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


vehlcle_ 


speed. 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


vehlcle_ 


trail . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


vehl cl e_ 


collision . 
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SCRIPT 


ERROR : 


Invalid 


parameters 


for 


vehicle^explosion . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


vehicle_f laming . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


vehicle_smoking . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


veh i cl e_des t royed . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


vehicle fuel. 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


vehicle^ammunition . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


vehicle_update . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


vehicle_status_query . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


object_activate. 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


object^deactivate. 


SCRIPT 


ERROR : 


Invalid 


parameters 


for 


object_collision. 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


object_explosion. 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


object_f laming. 


SCRIPT 


ERROR : 


Invalid 


parameters 


for 


object^smoking. 


SCRIPT 


ERROR : 


Invalid 


parameters 


for 


object^update . 


SCRIPT 


ERROR : 


Invalid 


parameters 


for 


object_status_query. 


SCRIPT 


ERROR : 


Invalid 


parameters 


for 


script_time_f actor . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


script_time_adjustment 


SCRIPT 


ERROR : 


Invalid 


parameters 


for 


script_delay . 


SCRIPT 


ERROR : 


Invalid 


parameters 


for 


script_abort . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


script_call . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


script^chain . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


script_repeat . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


script_timestamp . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


script_location . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


weapon launch. 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


weapon^impact . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


weapon_expl osi on . 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


weapon update. 


SCRIPT 


ERROR: 


Invalid 


parameters 


for 


weapon status_query. 
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APPENDIX B 

NPSNET-OASIS Sample Scripts 






File : 

Description : 

Host Id Number: 
Simulator : 

Author : 

**★******★*★**★★***★★**★ 



script . ml 

Sample script of two M-1 tanks in motion 
501 

NPSNET on IRIS VGX Workstation 
Phillip West 

'k’k'k’k'k'k’k'k’k'k’k'k'k'k’k’k'k'k'k'k'k'k'k'k’k'k'k'k'k'k'k'k'k’k'k'k'k'k'kic'k'k'k 



*/ 



/* Assign timestamp reference relative to start time of input script */ 
SCRIPT_TIMESTAMP relative 

/* Assign default UTM gridzone and MGRS */ 

SCRIPT LOCATION IIS-DN 



/* Assign time factor of 50 percent for all timestamps */ 
SCRIPT_TIME_FACTOR 0 . 5 

/* Assign time adjustment value of 10 seconds for all timestamps */ 
SCRIPT TIME ADJUSTMENT 10.0 



/* Activate clouds with velocity 5.0 km/h^ heading 270.0 west */ 
ENVIRONMENT__ACTIVATE 5010500 Cloud 270.0 5.0 34536783 1000.0 30.0 

/* Activate two M-1 tanks */ 

VEHICLE_ACTIVATE 5010001 Ml 090.0 40.0 344955 0.0 40.0 

VEHICLE ACTIVATE 5010002 Ml 090.0 40.0 345958 0.0 45.0 



/* Change headings of M-1 tanks 
VEHICLE_HEADING 5010001 
VEHICLE HEADING 5010002 



*/ 

135.0 344801 0.0 2:0.0 

120.0 344803 0.0 2:5.0 



/* Change velocities of M-1 tanks */ 

VEHICLE_SPEED 5010001 5.0 344670 0.0 6:0.0 

VEHICLE SPEED 5010001 5.0 344677 0.0 7:25.0 



/* M-1 tanks passing by a building */ 

OBJECT_ACTIVATE 5010004 Building 344701 0 8:10.0 

OBJECT_DEACTIVATE 5010004 9:40.0 

/* Script message for advance warning of upcoming script events */ 
SCRIPT_MESSAGE Activating column of jeeps 

/* Script call for column of jeeps */ 

SCRIPT_CALL script-2 . jeeps 



49 



/* Continue script with next script file */ 
SCRIPT_CHAIN script-1 .ml 



File: script-1. ml 

Description: Sample script of two M-1 tanks in motion 

Host Id Number: 501 

Simulator: NPSNET on IRIS VGX Workstation 

Author: Phillip West 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ ! 



/* M-1 tanks passing by 
OBJECT_ACTIVATE 
OBJECT DEACTIVATE 



a palm tree */ 

5010003 PalmTree 345700 0 22:0.0 
5010003 22:35.0 



/* Change velocities of 

VEHICLE_SPEED 

VEHICLE SPEED 



M-1 tanks */ 

5010001 5.0 345670 0.0 26:0.0 
5010001 5.0 345677 0.0 27:25.0 



/* Deactivate M 1 tanks 
VEHICLE_DEACTIVATE 
VEHICLE DEACTIVATE 



*/ 

5010001 29:45.0 
5010002 29:50.0 



/* Deactivate column of jeeps */ 
SCRIPT_CALL script-3 . jeeps 



/* Continue script with another scenario */ 
SCRIPT_CALL script-4 . f 14 



/* Deactivate clouds */ 

ENVIRONMENT DEACTIVATE 5010500 45:0.0 



/* Script delay for duration of 2 minutes prior to termination */ 
SCRIPT_DELAY 2:0.0 absolute 

/* Write to output script file message for next script processing */ 
SCRIPT_FILE_WRITE SCRIPT_MESSAGE End of Script 

/* script message for end of script */ 

SCRIPT MESSAGE *** DEMO COMPLETE *** 



/* Terminate script */ 
SCRIPT ABORT 
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File: 


script-2 . jeeps 


Description : 


Sample script of activating multiple jeeps 


Host Id Number: 


501 


Simulator : 


NPSNET on IRIS VGX Workstation 


Author : 


Phillip West 






/* Activate jeep vehicle */ 



VEHICLE ACTIVATE 



5010010 Jeep 090.0 40.0 345678 0.0 10:0.0 



/* Repeat script for 10 iterations with total 11 separate vehicles */ 
SCRIPT REPEAT 10 1 1:0.0 



^'k'k'k'k'k'k'k'k-k'k'k'k'k'k'k'ki^i^'k'k'ki^'k'k'ki^-k-k'k'^'k'kic'k'k'k'k'k'k'k'k'K'k'k'A'k'k'k'k'k'k-k'k'kic-K'k'ki^ik'kiQ'K'k'Ki^'k 

File: script-3 . jeeps 

Description: Sample script of deactivating multiple jeeps 

Host Id Number: 501 

Simulator: NPSNET on IRIS VGX Workstation 

Author: Phillip West 

/* Deactivate jeep vehicle */ 

VEHICLE_DEACTIVATE 5010010 29:0.0 

/* Repeat script for 10 iterations with total 11 deactivate jeeps */ 
SCRIPT REPEAT 10 1 1.0 
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/******************************************************************* ♦ 



File: 

Description : 
Host Id Number: 
Simulator : 
Author: 



script-4 . f 14 

Sample of a script of a flying aircraft 
501 

NPSNET on IRIS VGX Workstation 
Phillip West 






/* Activate F-14 aircraft in flight status */ 

VEHICLE_ACTIVATE 5010110 F14 090.0 540.0 345678 1000.0 30:0.0 

/* Aircraft roll to port 10 degrees */ 

VEHICLE_ROLL 5010110 10.0 port 344677 1000.0 31:10.0 

/* Aircraft level roll to 0 degrees */ 

VEHICLE_ROLL 5010110 0.0 none 344676 996.7 34:56.5 

/* Sea sparrow launch from F-14 */ 

WEAPON_LAUNCH 5010210 5010110 seasparrow 240.0 R 400.0 -10. 0\ 

344675 995.6 36:0.0 



/* Weapon impact on surface */ 

WEAPON_IMPACT 5010210 5010110 342670 0.0 38:43.5 

/* Weapon exploded on surface */ 

WEAPON EXPLOSION 5010210 5010110 342670 0.0 39:0.0 



/* Deactivate F-14 */ 

VEHICLE DEACTIVATE 5010110 43:0.0 
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APPENDIX C 



// Classtype: 

// Derived from: 
// 

// 

// Base for: 

// Remarks: 

// 

// 



Class Definition of ScriptProcessor 

ScriptProcessor 

VehicleProcessor, Weapon? rocess or , 

MiscObject Processor, EnvironmentProcessor , 

ScriptOptionProcessor 

OasisSystem 

This class provides the mechanism to read script 
files and process script events for valid script 
objects and comments. 



class ScriptProcessor : private VehicleProcessor, 

private WeaponProcessor , 
private MiscOb jectProcessor , 
private EnvironmentProcessor , 
private ScriptOptionProcessor { 

public : 

ScriptProcessor () ; // Constructor 

^ScriptProcessor () ; // Destructor 

// Member functions for ScriptProcessor 
long ReadScriptOb ject (ScriptOb ject& Script) ; 

// Reads next script object from input script file and 
/ / returns null if error occurs . 

SourceScriptFile* GetScriptFile () ; 

// Returns reference pointer of current input script file, 
void SetScriptFile (SourceScriptFile* Scriptfile) ; 

// Assigns current script file for script processing, 
void SetUtmScriptDef aults (char *Gridzone, char *Mgrs); 

// Assigns default gridzones and mgrs for event positions. 
ScriptProcessor* Instance ()/ 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 



protected: 

SourceScriptFile* Cu r rent Script File; 

// Current input script file. 

private : 

long SetupScriptLine (char *Line) ; 

// Removes excess blank spaces and converts uppercase 
// characters to lower case. Returns SCRIP T_COMMENT 
//if script line is the beginning of a comment block, 
long ScanForBlankLines (char *Line) ; 

// Returns null for non-blank lines. 
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long 



DetermineEvent (ScriptOb ject & Script, char* Line); 

// Determines procedural operator for script object, and 
// calls group processor for procedural operator. Returns 
// null if script error occurs. 

// end class ScriptProcessor 
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APPENDIX D 

Class Definition of ScriptGenerator 



// 

// 

// 

// 

// 

// 

// 



Classtype : 


ScriptGenerator 


Derived from: 


OasisSystemOb ject 


Base for: 


OasisSystem 


Remarks : 


This class provides the mechanism in writing script 




files . 



class ScriptGenerator : public OasisSystemOb ject { 
public : 

ScriptGenerator () ; // Constructor. 

--ScriptGenerator () ; // Destructor. 

// Member functions for ScriptGenerator 
long OpenOutputFile (char *Name) ; 

// Opens output script file and returns TRUE for successful 
// file open. 

long WriteScriptOb ject (ScriptOb ject& Script) ; 

// Writes script object to script file and returns TRUE for 
// successful file write, 
long WriteScriptLine (char *Line) ; 

// Writes script object to script file and returns TRUE for 
// successful file write, 
long CloseOutputFile ( ) ; 

// Closes output script file and returns result of file 
// close. 

ScriptGenerator* Instance (); 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string, 

protected: 

DestinationScriptFile OutFile; 

// Current destination script file. 

private : 

void WriteVehicleEvent (VehicleEvent& Vehicle); 

// Writes script object of vehicle event to output script 
// file. 

void WriteWeaponEvent (WeaponEvent& Weapon); 

// Writes script object of weapon event to output script 
// file. 

void WriteMiscOb jectEvent (MiscOb jectEvent& MiscObject) ; 

// Writes script object of miscellaneous object event to 
// output script file. 

void WriteEnvironmentEvent (EnvironmentEvent & Environment); 

// Writes script object of environment event to output 
// script file. 
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void WriteComment { S cript Comment & Comment) ; 

// Writes script comment block to output script file. 
); // end class ScriptGenerator 
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APPENDIX E 

Class Definition of TimeKeeper 



// 

// 

// 

// 

// 

// 

// 

// 



Classtype : 


TimeKeeper 




Derived from: 


OasisSystemOb ject 




Base for: 


OasisSystem 




Remarks : 


This class provides the functions to 


keep track of 




time, and convert to and from script 
timestamps . 


object 



class TimeKeeper : public OasisSystemOb ject { 
public : 

TimeKeeper 0 ; // Constructor 

TimeKeeper (long Reference); // Constructor 

-TimeKeeper 0 / // Destructor 

// Member functions for TimeKeeper 
long GetClockRef erence ( ) ; 

// Returns clock reference of timekeeper, 
void SetClockRef erence (long Reference); 

// Assigns clock reference of timekeeper, 
void StartSystemTime () ; 

// Saves time of system start, 
void Start InputScriptTime () ; 

// Saves time of start for input script, 
void StartOutput ScriptTime ( ) ; 

// Saves time of start for output script, 
void SetSystemStartTime (long Seconds, long Microseconds); 

// Assigns system start time. 

void SetInputScriptStartTime (long Seconds, long Microseconds) ; 

// Assigns start time for input script file, 
void SetOutputScriptStartTime (long Seconds, long Microseconds); 

// Assigns start time for output script file, 
void Current SystemTimestamp (ScriptEventS Event); 

// Assigns timestamp of script object to current system 
// time (Absolute or Relative) . 

void ScriptToSystemTimestamp (ScriptEventS Event, long Reference); 
// Modifys timestamp of script object to reflect time 
// reference to system time. 

void SystemToScriptTimestamp (ScriptEvent& Event, long Reference); 

// Assigns timestamp of script object to reflect reference 
// to start of system time or start of input script file, 
void SetScriptDelay (ScriptEvent & Delay, long Reference); 

// Assigns time to disable script delay based on type of 
// delay. Absolute delay is based on system start time. 

// Relative is based on duration of delay, 
long ActiveScriptDelay ( ) ; 

// Returns TRUE if script delay is still active. 
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TimeKeeper* Instance ()/ 

// Returns reference pointer of instance, 
virtual char *ClassName { ) ; 

// Returns class identification string. 

private : 

long ClockReference; 

// Time reference for time keeper. 

TimeValue Sy stem_S tart time; 

// Start time of system. 

TimeValue InputScript_Starttime; 

// Start time of input script. 

TimeValue OutputScript_Starttime; 

// Start time of output script. 

TimeValue End_Of_DelayTime; 

// Time to release script delay, 
void ConvertToTimestamp (TimeValue *time^ ScriptEventS Event) 
// Converts system time to script object timestamp. 

}; // end class TimeKeeper 
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APPENDIX F 

Class Definition of OasisSystem 



// Classtype: 

// Derived from: 
// Base for: 

// Remarks: 

// 

// 



OasisSystem 

TimeKeeper, ScriptProcessor , ScriptGenerator 
Oasis Script Sorter, Oasis Script? reprocessor 
This class provides the mechanism for reading and 
writing script files. All script options are 
processed internally. 



class OasisSystem : private TimeKeeper, 

private ScriptProcessor , 
private ScriptGenerator { 

public : 

OasisSystemO ; // constructor 

OasisSystem (long ClockRef erence) ; // constructor (use SYSTEM_CLOCK 

// for reference in system time 
// access, or use USER_CLOCK for 
// time provide by the user. 

-OasisSystemO; // destructor 

// Member functions for OasisSystem 
long Openinput ScriptFile (char *Name) ; 

// Opens script file for input. Returns TRUE for successful 
// file open. 

long OpenOutputScriptFile (char ^Narne) ; 

// Opens script file for output. Returns TRUE for 
// successful file open, 
long GetScriptOb ject (ScriptOb ject& Script); 

// Requires ScriptObject as argument for script event I/O. 
// The script object is returned with result of either - 
// SCRIPT_ERROR, SCRIPT_VALID, END_OF_SCRIPT, 

// SCRIPT_IN_DELAY, or NO_S CRT PT_E VENT . 
long PutScriptOb ject (ScriptOb ject& Script) ; 

// Writes script object to output script file and returns 
// TRUE for successful file write, 
long CloseInputScriptFile ( ) ; 

// Closes input script file and returns result of TRUE for 
// successful file close, 
long CloseOutputScriptFile () ; 

// Closes input script file and returns result of TRUE for 
// successful file close, 
double GetTimeFactor ( ) ; 

// Returns time factor for computing timestamps for all 
// script objects. 

void SetTimeFactor (double Factor); 

// Assigns time factor for computing timestamps for all 
// script objects. 
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void 



SetSystemStartTime (long Seconds, long Microseconds); 

// Only used in USER_CLOCK time reference, the system 
// starttime is altered to match total seconds and 
// microseconds. Start times for input and output script 
// files will be the same for system start time, 
void DisableScriptMessagesAndDelays () ; 

// Sets flag for no script messages to be displayed and 
// no script delays to be activated 
Oasis System* Instance ( ) ; 

// returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// returns class identification string. 

protected: 

SourceScriptFile *CurrentInputFile; 

// Reference to current input scriptfile 

private : 

long EndOf Input Script ; 

// Boolean flag for end of script file, 
long DelayActive; 

// Boolean flag for active script delay, 
long MessagesAndDelays ; 

// Initially TRUE allowing script messages and delays 
double TimeAdjustment / 

// Amount of time to adjust script timestamps, 
double TimeFactor; 

// Time factor for each computed timestamp, 
long TimeReference; 

// Time reference for determining type of timestamp for 
// script object. ABSOLUTE_TIME for assigning timestamps 
// relative to system start time. RELATIVE_TIME for 
// assigning timestamps relative to input script start 
// time. 

void ModifyScriptOb ject (ScriptEvent& Event); 

// Modifys script object in computing timestamps according 
// to time reference time adjustment, and time factor, 
long ProcessScriptOption (ScriptOption& Option); 

// Process script option for OASIS. Returns either 
// SCRIPT_VALID or END_OF_SCRIPT . 
long DelayScript (ScriptOption& Option); 

// Assigns script delay based on type of reference in time 
// delay. If absolute, delay is aborted when system time 
// matches time of delay. If relative, time of delay is 
// added to time of receiving script object for reference, 
long ChainScript (ScriptOption& Option); 

// Closes current script file and opens another. Returns 
// null if error occurs, 
long CallScript (ScriptOption& Option); 

// Calls script file as a subroutine and returns back to 
// calling script file. Returns null if error occurs 
// during file open. 
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long 



RepeatScript (ScriptOption& Option) ; 

// Repeats current script file for number of iterations. 
}; // end class OasisSystem 
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APPENDIX G 

Class Definition of OasisScriptSorter 



//= 

// 


Classtype : 


OasisScriptSorter 


// 


Derived from: 


OasisSystem 


// 


Base for: 


none 


// 

// 

// 


Remarks : 


This class provides the mechanism to sort script 
objects of source script files and writes back to a 
destination script file. The qsort function of 


// 

//= 


II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 


ANSI C is used for sorting. 



class OasisScriptSorter : private OasisSystem { 
public : 

OasisScriptSorter ( ) ; // Constructor 

-OasisScriptSorter ( ) / // Destructor 

// Member functions for OasisScriptSorter 
long PerformSort (char *Source, char *Destination ) ; 

// Performs sort of source script file and generates sorted 
// script to a destination script file. Source and 
// Destination can be the same file name. 

OasisScriptSorter* Instance (); 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 

private : 

long ReadScriptFile (char *Source) / 

// Reads script file into sort array and returns TRUE for 
// valid script file or FALSE for invalid script file, 
long WriteScriptFile (char *Destination) ; 

// Writes script objects from sort array to destination 
// script file. Returns TRUE if valid script write, 
long NumberOf Entries; 

// Returns number of script objects in sort array. 
ScriptSource *Script; 

// Array for sorting script objects, 
void CreateSortArray ( ) ; 

// Creates sorting array, 
void Dest roySortArray ( ) ; 

// Destroys sorting array, 
double GetTimestamp (ScriptOb ject& Source) ; 

// Returns timestamp in total seconds and microseconds from 
// script object, 
double PreviousTimestamp; 

// Timestamp of previous script object, 
long PreviousOb jectWasAComment ; 

// Boolean flag for previous script object. 

}; // end OasisScriptSorter 
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APPENDIX H 

Class Definition of OasisScriptPreprocessor 



//= 

// 


Classtype : 


OasisScriptPreprocessor 


// 


Derived from: 


OasisSystem 


// 


Base for: 


none 


// 


Remarks : 


This class provides a mechanism to check source 


// 

//= 


II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 


script files errors prior to use. 



class OasisScriptPreprocessor : private OasisSystem { 
public : 

OasisScriptPreprocessor 0 ; // Constructor 

--OasisScriptPreprocessor 0 ; // Destructor 

// Member functions for OasisScriptPreprocessor 
long Perf ormErrorChecking (char ^Source) ; 

// Reads script file and displays to standard output device 
// of all errors in script file. 

OasisScriptPreprocessor* Instance () ; 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 

)/ // end OasisScriptPreprocessor 
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APPENDIX I 

Class Definitions of Script Events and Attributes 



// Classtype: 

// Derived from: 
// Base for: 

// Remarks: 

// 



ObjectHeading 

Event At tribute 

VehicleEvent , WeaponEvent, EnvironmentEvent 
This class provides functions for object headings 
in degrees . 



class ObjectHeading : public EventAtt ribute { 
public : 

Ob jectHeading ( ) ; // Constructor 

--Ob jectHeading ( ) ; // Destructor 

// Member functions for ObjectHeading 
void SetHeading (float Value); 

// Assigns object heading in degrees, 
float GetHeading ( ) ; 

// Returns object heading in degrees, 
void SetHeadingType (char Type) ; 

// Assigns heading type, 
char GetHeadingType () ; 

// Returns heading type as a string (absolute or relative) . 
ObjectHeading* Instance (); 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 

private : 

float Heading; 

// Heading of object in degrees, 
char HeadingType; 

// Heading in Relative direction 'r' 

// or Absolute direction 'a' 

}; // end class ObjectHeading; 



// Classtype: 

// Derived from: 
// Base for: 

// Remarks: 

// 



ObjectVelocity 

EventAtt ribute 

VehicleEvent , WeaponEvent, EnvironmentEvent 
This class provides functions for object velocity 
in kilometers per hour. 



class ObjectVelocity : public EventAtt ribute { 
public : 

Ob jectVelocity ( ) ; // Constructor 

--Ob jectVelocity ( ) ; // Destructor 
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// Member functions for Ob jectVelocity 
float GetVelocity ( ) ; 

// Returns object velocity in km/h. 
void SetVelocity (float Value); 

// Assigns object velocity in km/h. 

Ob jectVelocity* Instance (); 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 

private : 

float Velocity; 

// Velocity of object in kilometers per hour. 
}; // end class Ob jectVelocity; 



Classtype : 
Derived from: 
Base for: 
Remarks : 



// = 

// 

// 

// 

// 

// 

class Ob jectPitchAngle 
public : 

Ob jectPitchAngle ( ) ; 

--Ob jectPitchAngle ( ) 



Object PitchAngle 

Event At tribute 
VehicleEvent , WeaponEvent 

This class provides the functions for object pitch 
angle in degrees. 



public EventAttribute { 



// Constructor 
// Destructor 
// Member functions for Ob jectPitchAngle 
float GetPitchAngle ( ) ; 

// Returns object pitch angle in degrees, 
void SetPitchAngle (float Angle); 

// Assigns object pitch angle in degrees. 
Ob jectPitchAngle* Instance ()/ 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// returns class identification string. 



private : 

float PitchAngle; 

// Object's pitch angle in degrees. 
}; // end class Ob jectPitchAngle; 



//= 

// 


Classtype : 


ObjectRoll 


// 


Derived from: 


EventAttribute 


// 


Base for: 


VehicleEvent 


// 


Remarks : 


This class provides functions for object roll. 


class ObjectRoll : 


public EventAttribute { 


public : 






ObjectRoll ( ) ; 


// Constructor 




-ObjectRoll ( ) ; 


// Destructor 
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// Member functions for ObjectRoll 



float 


GetRollAngle ( ) ; 

// Returns roll angle in degrees. 


void 


SetRollAngle (float Angle); 

// Assigns roll angle in degrees. 


char 


*GetRollDirection ( ) ; 

// Returns roll direction of either "port” or "stbd” 


void 


SetRollDirection (char *Direction) ; 



// Assigns roll direction. 

ObjectRoll* Instance () ; 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 



private : 
float 


// Returns class identification string. 
RollAngle; 

// Roll angle of object (in degrees) 


char 


* RollDi recti on; 

// Direction of pitch (port or stbd) 



); // end class ObjectRoll; 

//====^=^==„„=========^===.========================================= 

// ciasstype: ObjectComponent 

// Derived from: EventAttribute 

// Base for: VehicleEvent 

// Remarks: This class provides functions for object component 



// 

// 

// 


All movements of object component are represented 
by the six degrees of freedom for translation and 
rotation. 



class ObjectComponent : public EventAttribute { 
public : 

Ob jectComponent 0 ; // Constructor 

'-ObjectComponent 0 ; // Destructor 

// Member functions for ObjectComponent 



char 


*GetComponentName () ; 

// Returns name of object component. 


void 


SetComponentName (char *Name) ; 

// Assigns name to object component. 



float GetComponentRotation (long Axis); 



void 


// Returns component rotation in the requested axis. 
SetComponentRotation (float Xval, float Yval, float Zval) ; 
// Assigns component rotation in the X, Y^ and Z axis. 



float GetComponentTranslation (long Axis) ; 



void 


// Returns component translation in the requested axis. 
SetComponentTranslation (float Xval, float Yval, float Zval) 



// Assigns component translation in the X, Y, and Z axis 
ObjectComponent* Instance () ; 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 
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private : 

char * Comp on ent Name; 

// Component name of object, 
float ComponentRotation [XYZ] ; 

// Degrees of freedom in rotation, 
float ComponentTranslation [XYZ] ; 

// Degrees of freedom in translation. 
); // end class Ob jectComponent ; 



// 

// 

// 

// 

// 

// 

// 



Classtype : 
Derived from: 
Base for: 
Remarks : 



ObjectWeapon 

Event Att ribute 
VehicleEvent 

This class provides functions for object weapons. 
Usually components on vehicles. 



class ObjectWeapon : public EventAttribute { 
public : 

Ob jectWeapon ( ) ; // Constructor 

"Ob jectWeapon ( ) ; // Destructor 

// Member functions for ObjectWeapon 



long 


GetWeaponRounds () ; 

// Returns number of rounds in 


weapon 


void 


SetWeaponRounds (long Rounds); 
// Assigns number of rounds to 


weapon 


char 


*GetWeaponName ( ) ; 






// Return name of weapon. 




void 


SetWeaponName (char *Name) ; 
// Assigns name of weapon. 




ObjectWeapon* Instance (); 





// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 

private : 

char *WeaponName; 

// Weapon component name, 
long WeaponRounds; 

// Number of rounds in Weapon. 

); // end class ObjectWeapon 
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// 

// 

// 

// 

// 

// 



Classtype : 
Derived from: 
Base for: 
Remarks : 



ObjectExpIosion 

Event At tribute 

VehicleEvent , WeaporiEvent, MiscOb jectEvent 

This class provides functions for object explosions 



class ObjectExpIosion : public EventAttribute { 
public : 

Ob jectExplosion ( ) ; // Constructor 

^ObjectExpIosion 0 ; // Destructor 

// Member functions for ObjectExpIosion 
char *GetExplosionDescription ( ) ; 

// Returns description of explosion, 
void SetExplosionDescription (char *Description) ; 

// Assign description of object explosion, 
float GetExplosionBoundArea (long Axis); 

// Return coordinate of explosion bound area along 
// requested axis. 

void SetExplosionBoundArea ( float Xval^ float Yval, float Zval) ; 

// Assign X, Y, and Z coordinates of explosion bound area. 
ObjectExpIosion* Instance (); 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 

private : 

char *ExplosionDescription; 

// Descriptive type of explosion, 
float ExplosionBoundArea [XYZ] ; 

// Maximum area bound in X, Y, Z coordinates, 

); // end class ObjectExpIosion; 



//= 

// 


Classtype : 


ObjectFireAndSmoke 


// 


Derived from: 


EventAttribute 


// 


Base for: 


VehicleEvent , WeaponEvent, MiscOb jectEvent 


// 


Remarks : 


This class provides functions for all object fire 


// 

//= 


II 

II 

II 

II 

II 

II 

II 

II 

II 

11 

II 

II 

II 

II 

II 


and smoke events. 



class Ob jectFireAndSmoke : public EventAttribute { 
public : 

Ob jectFireAndSmoke 0 ; // Constructor 

^Ob jectFireAndSmoke 0 ; // Destructor 

// Member functions for Ob jectFireAndSmoke 
char *GetFireAndSmokeDescription ( ) ; 

// Returns descriptive type of smoke or fire, 
void SetFireAndSmokeDescription (char *Description) ; 

// Assigns descriptive type of smoke or fire on object, 
float GetFireAndSmokeBoundArea (long Axis) ; 

// Returns coordinate of requested axis of maximum bound 
// area of smoke or fire. 
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void 



SetFireAndSmokeBoundArea (float Xval^ float Yval, float Zval) ; 
// Assigns coordinates of X, Y, and Z axis maximum bound 
// area of smoke or fire, 
float GetFireAndSmokeOff set (long Axis) ; 

// Returns coordinate of requested axis of smoke or fire 
// offset on object. 

void SetFireAndSmokeOff set (float Xval, float Yval, float Zval) ; 

// Assigns coordinates of X, Y, and Z axis smoke or fire 
// offset on object. 

Ob jectFireAndSmoke* Instance () ; 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 



private : 
char 

float 

float 

}; // end 



*FireAndSmokeDescription; 

// Descriptive type of smoke or flame on object. 
FireAndSmokeBoundArea [XYZ] / 

// maximum area bound in X, Y, and Z coordinates. 
FireAndSmokeOf f set [XYZ] ; 

// Offset coordinates on object, 
class Ob jectFireAndSmoke; 



//=============== 

// Classtype: 

// Derived from: 
// Base for: 

// Remarks: 



ObjectTrail 

Event At tribute 
VehicleEvent 

This class provides functions for object trails. 



class ObjectTrail : public EventAtt ribute { 
public : 

Ob jectTrail ( ) ; // Constructor 

^Ob jectTrail ( ) ; // Destructor 

// Member functions for ObjectTrail 
char *GetTrailDescription ( ) ; 

// Returns description of object trail, 
void SetTrailDescription (char ^Description) ; 

// Assigns description to object trail, 
float GetTrailBoundArea (long Axis); 

// Returns coordinate of trail bound area along request 
// axis. 

void SetTrailBoundArea (float Xval, float Yval^ float Zval) ; 

// Assigns maximum bound area coordinates for X, Y, and Z. 
float GetTrailOff set (long Axis); 

// Returns coordinate of trail offset along request axis, 
void SetTrailOff set (float Xval, float Yval, float Zval) ; 

// Assigns object coordinates in X, Y, and Z for trail 
// offset. 

ObjectTrail* Instance () ; 

// Returns reference pointer of instance. 
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virtual char *ClassName () / 

// Returns class identification string. 



private : 
char 

float 

float 

) ; II end 



* TrailDe script ion; 

// Descriptive type of object trail. 
TrailBoundArea [XYZ] ; 

// Maximum area bound of trail. 
TrailOffset [XYZ] ; 

// Offset position on object, 
class Ob jectTrail; 



//= 

// 


Classtype : 


ObjectFuel 


II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 


// 


Derived from: 


EventAttribute 




// 


Base for: 


VehicleEvent 




// 


Remarks : 


This class provides 


functions for object fuel. 


// 

//= 


II 

11 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 


Fuel is represented 


in Liters. 



class ObjectFuel : public EventAttribute { 
public : 

Ob jectFuel ( ) ; // 

-ObjectFuel 0 ; // 

// Member functions for ObjectFuel 



Constructor 

Destructor 



for 

float GetFueK); 

// Returns amount of fuel in liters 
void SetFuel ( float Value); 

// Assigns amount of fuel in 
ObjectFuel* Instance () ; 

/ / Returns reference pointer 
virtual char *ClassName ( ) ; 



liters . 



of instance. 



// Returns class identification string. 



private : 

float Fuel; 

// Fuel state of Object (liters) . 
); // end class ObjectFuel; 



// 

// 

// 

// 

// 

// 

// 



Classtype : 
Derived from: 
Base for: 

Remarks : 



EventObject 

OasisEventOb ject 

VehicleEvent , WeaponEvent, MiscOb jectEvent , 

Envi ronment Event 

This class provides functions for all event object 



class EventObject : public OasisEventOb ject { 
public : 

EventOb ject ( ) ; // Constructor 

-EventOb ject ( ) ; // Destructor 
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// Member functions for OasisEventOb ject 



long 


ConvertIdFromLongInteger (long Id) ; 






// Converts a number to host and object 
// numbers. 


identification 


long 


ConvertIdToLongInteger ( ) ; 






// Returns number representing host and 


object id numbers 


long 


GetHostNumber ( ) ; 

// Returns host number of object. 




void 


SetHostNumber (long Number); 

// Assigns host number for object. 




long 


GetOb jectNumber ( ) ; 






// Returns object identification number 


of object. 


void 


SetOb jectNumber (long Number); 






// Assigns object identification number 


to object. 


char 


*GetOb jectDescription () ; 

// Returns object description. 




void 


SetOb jectDescription (char *Description) ; 
// Assigns description to object. 




char 


*GetOb jectStatus () ; 

// Returns descriptive status of object. 




void 


SetOb jectStatus (char *Status) ; 

// Assigns descriptive status of object. 




EventObject* Instance (); 






// Returns reference pointer of instance. 


virtual char *ClassName ( ) ; 

// returns class identification string. 

private : 




long 


Ob jectHostNumber ; 

// Host identification number of object. 




long 


Ob jectNumber; 

// Object identification number. 




char 


*0b ject Descript ion; 

// Description type of object. 




char 


*0b jectStatus ; 

// Descriptive status of object. 





}; // end EventObject 



// Classtype: 

// Derived from: 
// Base for: 

// Remarks: 



WeaponSource 

EventAt tribute 
WeaponEvent 

This class provides functions for weapon source. 



class WeaponSource : private EventAttribute { 
public : 

WeaponSource 0 ; // Constructor 

-WeaponSource 0 ; // Destructor 
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// Member functions for WeaponSource 
EventObject& GetWeaponSource ( ) ; 

// Returns source object of weapon, 
void SetWeaponSource (EventOb ject& Source); 

// Assigns source object of weapon. 
WeaponSource* Instance (); 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 

private : 

EventOb ject Sou rceOf Weapon; 

// Source object assocated with weapon. 

); It end class WeaponSource 



//================================================================== 

// ciasstype: TimeStamp 

// Derived from: OasisEventOb ject 

// Base for: ScriptEvent 

// Remarks: This class provides functions for all timestamps. 

//=====.============================================================= 

class Timestamp : public OasisEventOb ject { 
public : 

TimeStampO; // Constructor 

^Timestamp ( ) ; // Destructor 

/ / Member functions for TimeStamp 
void SetHours (long Value) ; 

// Assigns hours in timestamp, 
long GetHoursO; 

// Returns hours in timestamp, 
void SetMinutes (long Value); 

// Assigns minutes in timestamp, 
long GetMinutes ( ) ; 

// Returns minutes in timestamp, 
void SetSeconds (long Value); 

// Assigns seconds in timestamp, 
long Get Seconds () ; 

// Returns seconds in timestamp, 
void SetMicroseconds (long Value) ; 

// Assigns microseconds in timestamp, 
long GetMicroseconds () ; 

// Returns microseconds in timestamp, 
long StringToTimestamp (char *Timestring) ; 

// Converts timestamp string to hours, minutes, seconds, 
// and microseconds, 
char *TimestampToString ( ) ; 

// Returns timestamp as a string. 

TimeStamp* Instance (); 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 
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private : 






long 


Hours; 

// Timestamp 


hours . 


long 


Minutes ; 

// Timestamp 


minutes . 


long 


Seconds; 

// Timestamp 


seconds. 


long 


Microseconds; 
// Timestamp 


microseconds . 


char 


*TimeString; 






// Timestamp 


in string format. 



}; // end class TimeStamp 



// Classtype: 

// Derived from: 
// Base for: 

// Remarks: 

// 



EventPosition 

OasisEventOb ject 
ScriptEvent 

This class provides functions for UTM coordinates 
and elevations. 



class EventPosition : public OasisEventOb ject { 
public : 

EventPosition 0 / // Constructor 

--EventPosition 0 ; // Destructor 

// Member functions for EventPosition 
void SetGridzone (char *NewGridzone) ; 

// Assigns gridzone of UTM position 
char *GetGridzone () ; 

// Returns gridzone of UTM coordinates, 
void SetMgrs(char *NewMgrs) ; 

// Assigns MGRS of UTM coordinates, 
char *GetMgrs(); 

// Returns MGRS of UTM coordinates, 
void SetNorthing (long Value); 

// Assigns Northing of UTM coordinates, 
long GetNorthing ( ) ; 

// Returns Northing of UTM coordinates, 
void SetEasting (long Value); 

// Assigns Easting of UTM coordinates, 
long GetEasting ( ) ; 

// Returns Easting of UTM coordinates, 
void SetElevation (float Value); 

// Assigns elevation, 
float GetElevation ( ) ; 

// Returns elevation. 

long St ringToUtmPosition (char *Position, char *defaultGZ, 

char *def aultMGRS) ; 

// Extracts UTM coordinates from Position, and returns null 

// if error occurs. Default gridzone and mgrs are required 

// for UTM defaults. 
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long 



St ringToMap (char *map_strg, char *defaultGZ, 
char *defaultMGRS) ; 

// Extracts default UTM gridzone and/or Mgrs, and returns 
// null if error occurs, 
char *UtmPositionToString ( ) ; 

// Returns UTM coordinates as a string. 

EventPosition* Instance () ; 

// Returns reference pointer of instance, 
virtual char *ClassName () ; 

// Returns class identification string. 



private : 




char 


*Gridzone; 

// grid zone of UTM coordinate system 


char 


*Mgrs ; 

// mgrs of UTM coordinate system 


long 


Northing; 

// northing offset of grid zone 


long 


Easting; 

// easting offset of grid zone 


float 


Elevation; 
// altitude 


char 


* Posit ionstring; 

// UTM coordinates in string format 



}/ // end class EventPosition; 



// Classtype: 

// Derived from: 

// 

// Base for: 

// 

// Remarks: 

// 

class ScriptEvent 



ScriptEvent 

EventObject, EventPosition^ EventAttribute, 
Timestamp 

VehicleEvent , WeaponEvent, MiscOb jectEvent ^ 
EnvironmentEvent ^ ScriptComment , ScriptOption 
This class is the base for all script events. Each 
script event must have an object, place, and time. 

: public EventObject, public EventPosition, 

private EventAttribute, public TimeStamp { 



public : 

ScriptEvent 0 ; // Constructor 

'“ScriptEvent 0 ; // Destructor 

// Member functions for ScriptEvent 
long GetEventType () / 

// Returns type of script event, 
void SetEventType (long Type); 

// Assigns type of script event, 
char *GetEventResult ( ) ; 

// Returns descriptive result of event, 
void SetEventResult (char ^Result) ; 

// Assigns descriptive result of event. 
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ScriptEvent* Instance () ; 

// Returns reference pointer to instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 

private : 

long EventType; 

// Type of script event, 
char *EventResult ; 

// Description result of event. 

}; // end class ScriptEvent 



// 

// 

// 

// 

// 

// 

// 

// 

// 



Classtype : 
Derived from: 



Base for: 
Remarks : 



VehicIeEvent 

ScriptEvent, Ob ject Heading, Ob jectVelocity , 

Ob jectPitchAngle, ObjectRoll, Ob jectComponent , 

Ob jectWeapon, Ob jectExplosion, Ob jectFireAndSmoke, 
Ob ject Trail , Ob jectFuel 
ScriptOb ject 

This class is for all vehicle events. 



class VehicIeEvent 



public ScriptEvent, public 
public ObjectVelocity, public 
public Ob jectPitchAngle, public 
public Ob jectComponent , public 
public Ob jectFireAndSmoke, public 
public Ob jectExplosion { 



public : 

VehicIeEvent () ; // Constructor 

'-VehicIeEvent 0 ; // Destructor 

// Member functions for VehicIeEvent 
VehicIeEvent* Instance (); 

// Returns reference pointer of instance 
virtual char *ClassName ( ) ; 

// Returns class identification string. 
); // end class VehicIeEvent 



Ob ject Heading, 
Ob jectFuel, 
ObjectRoll, 

Ob jectWeapon, 
Ob jectTrail , 



//= 

// 


Classtype : 


WeaponEvent 


// 


Derived from: 


ScriptEvent, WeaponSource, Ob jectHeading, 


// 




Ob jectPitchAngle, 


// 




ObjectVelocity, Ob jectExplosion 


// 


Base for: 


ScriptOb ject 


// 

//= 


Remarks : 


This class is for all Weapon events. 



class WeaponEvent : public ScriptEvent, public WeaponSource, 

public Ob jectHeading, public Ob jectPitchAngle, 
public ObjectVelocity, public Ob jectExplosion { 
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public : 

WeaponEvent ( ) ; // Constructor 

-WeaponEvent () / // Destructor 

// Member functions for WeaponEvent 
WeaponEvent* Instance (); 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 

}; // end class WeaponEvent 



// Classtype: 

// Derived from: 
// Base for: 

// Remarks: 



MiscObjectEvent 

ScriptEvent, Ob jectFireAndSmoke, Ob jectExplosion 
ScriptOb ject 

This class is for all miscellaneous object events. 



class MiscObjectEvent : public ScriptEvent, public Ob jectFireAndSmoke, 

public Ob jectExplosion { 

public : 

MiscObjectEvent 0 ; // Constructor 

-MiscObjectEvent 0 ; // Destructor 

// Member functions for MiscObjectEvent 
MiscObjectEvent* Instance (); 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 

}; // end class MiscObjectEvent 



// Classtype: 

// Derived from: 
// Base for: 

// Remarks: 



EnvironmentEvent 

ScriptEvent, Ob jectHeading, Ob jectVelocity 
ScriptOb ject 

This class provides is for all environment events. 



class EnvironmentEvent : public ScriptEvent, public Ob jectHeading, 

public Ob jectVelocity { 

public : 

EnvironmentEvent () ; // Constructor 

-EnvironmentEvent 0 / // Destructor 

// Member functions for EnvironmentEvent 
EnvironmentEvent* Instance (); 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 

}; // end class EnvironmentEvent 
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Classtype : 


ScriptComment 


Derived from: 


ScriptEvent 


Base for: 


ScriptOb ject 


Remarks: 


This class provides functions for script comments. 



// Pointer to comment line. 

// Pointer to next comment line. 



// Constructor 
// Destructor 



class ScriptComment : public ScriptEvent { 

// Data structure for each comment line 
typedef struct Comment Pointer { 
char *Line; 

struct CommentPointer *Next; 

} Comment Link; 
public : 

ScriptComment () ; 

-ScriptComment () ; 

// Member functions for ScriptComment 

long ReadFromFile (FILE *InputFile/ char *Line) ; 

// Reads from script file rest of comment block. Prior to 
// function call, first script line is already read, 
void DeleteComment () ; 

// Removes all comment lines in comment block, 
long GetNumberOf CommentLines ( ) ; 

// Returns number of lines in comment block. 

CommentLink *GetCommentBlock ( ) ; 

// Returns reference pointer to comment block, 
void SetCommentBlock (CommentLink *Block) ; 

// Assigns reference pointer to comment block, 
ScriptComment* Instance (); 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 

private : 

long NumberOf Comment Lines; 

// Number of lines in comment block. 

CommentLink *Comment; 

// Reference pointer to next comment line. 

} ; // end class ScriptComment 



// 

// 

// 

// 

// 

// 

// 



Classtype : 


ScriptOption 


Derived from: 


ScriptEvent 


Base for: 


ScriptOb ject 


Remarks : 


This class provides functions for parameters 


II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 


associated with script options. 



class ScriptOption : public ScriptEvent { 
public : 

ScriptOption 0 ; // Constructor 

-ScriptOption 0 ; // Destructor 



77 



// Member functions for ScriptOption 
double GetScriptTimeFactor ( ) ; 

// Returns script time factor, 
void SetScriptTimeFactor (double Factor); 

// Assigns script time factor, 
double GetScriptTimeAd justment () ; 



void 


// Returns script time adjustment. 
SetScriptTimeAdjustment (double Adjustment) ; 
// Assigns script time adjustment. 


char 


*GetDelayType () ; 

// Returns script delay type. 


void 


SetDelayType (char *Type) ; 

// Assigns script delay type. 


char 


*GetTimeReference () ; 

// Returns script time reference. 


void 


SetTimeReference (char *Reference) ; 

// Assigns time reference for assigning script timestamps 


char 


*GetScriptLine () ; 

// Returns script line or message. 


void 


SetScriptLine (char *Line) ; 

// Assigns script line or message. 


char 


*GetScriptFilename () / 

// Returns filename of script file. 


void 


SetScriptFilename (char *Name) ; 

// Assigns filename of script file. 


long 


GetScriptRepeatValue () ; 

// Returns script repeat value of iterations. 


void 


SetScriptRepeatValue (long Value) ; 

// Assigns script repeat value of iterations. 


long 


GetScriptOb jectNumberIncrement () / 

// Returns script object no. increment. 


void 


SetScriptOb jectNumberIncrement (long Value) ; 



// Assigns script object number increment. 
ScriptOption* Instance ( ) ; 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 



private : 
char 


// Returns class identification string. 
*DelayType; 

// Delay type in relative or absolute. 


char 


*TimeRef erence; 

// Time reference in relative or absolute. 


char 


*ScriptLine; 

// Reference pointer for script line or message. 


char 


* Script Filename; 

// Filename of script file. 


long 


RepeatValue; 

// Number of repeats for script file. 


long 


Ob jectNumberIncrement ; 

// Object number increment for each iteration. 
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double TimeFactor; 

// Time factor for computing timestamps, 
double TimeAd justment ; 

// Time adjustment for computing timestamps. 
); // end class ScriptOption 
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APPENDIX J 

Class Definition of ScriptObject 



// 

// 

// 

// 

// 

// 

// 

// 



Classtype : 


ScriptObject 


Derived from: 


VehicleEvent, WeaponEvent, MiscOb jectEvent , 
EnvironmentEvent, ScriptOption, ScriptComment 


Base for: 


none 


Remarks : 


This class provides functions for accessing script 




events . 



class ScriptObject : public VehicleEvent , 

public WeaponEvent, 
public MiscOb jectEvent , 
public EnvironmentEvent , 
public ScriptOption, 
public ScriptComment { 

public : 

ScriptObject 0 ; // Constructor 

--ScriptObject 0 ; // Destructor 

// Member functions for ScriptObject 
long Get ScriptEventType ( ) ; 

// Returns type of script event, 
void SetScriptEventType (long Type); 

// Assigns type of script event. 
VehicleEvent & GetVehicleEvent () / 

// Returns reference of vehicle event. 
WeaponEventS GetWeaponEvent () ; 

// Returns reference of weapon event. 
MiscOb jectEvent & GetMiscOb jectEvent () ; 

// Returns reference of misc object event. 
Environment Events GetEnvironmentEvent () / 

// Returns reference of environment event. 
ScriptOpt ions GetScriptOption ( ) ; 

// Returns reference of script option. 
ScriptComment & Get ScriptComment () ; 

// Returns reference of script comment. 
ScriptObject* Instance ( ) ; 

// Returns reference pointer of instance, 
virtual char *ClassName ( ) ; 

// Returns class identification string. 

private : 

long ScriptEventType; 

// Type of event for script object. 

}; // end class ScriptObject 
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APPENDIX K 

NPSNET-OASIS Network Interface 



The following NPSNET data structure is used for sending vehicle updates over the net. 
Attributes marked with an asterisk are used in the vehicle update message packet. 

Struct vehpostype { 



int 


vehtype; 


★ 


int 


control ; 


* 


int 


gunfire; 


•k 


int 


alive; 


* 


int 


rounds; 




int 


deadframes ; 




int 


coll_interval ; 




float 


pos [3] , 
eye [3] , 
lookatpt [3] , 
lookf rompt [3] ; 


* 


float 


direction, 


★ 




viewdi recti on, 


★ 




elev. 


* 




gunelev. 


★ 




speed, 
roll , 
pitch, 
gas, 

coll_range; 


★ 


end 


structure 





The following is an example of the transformation of a VEHICLE_ACTIVATE script 
event to a data structure in the local state of the world in NPSNET-OASIS network 
interface. 



Vehicle [Number ] .vehtype 

Vehicle [Number ] .control 
Vehicle [Number ] .gunfire 
Vehicle [Number ] .alive 
Vehicle [Number ] .rounds 
Vehicle [Number] .deadframes 
Vehicle [Number ] . coll_interval 
Vehicle [Number ] .pos[X] 

Vehicle [Number ] ,pos[Z] 

Vehicle [Number] .elev 
Vehicle [Number] . eye [X] 



LookForOb jectTypeNumber ( 

ScriptEvent . GetOb jectDescript ion { ) ) 
SCRIPTED; 

0 ; 

TRUE; 

DEFAULT_VEHICLE_ROUNDS ; 

0 ; 

0 ; 

ScriptEvent . GetEasting ( ) ; 
MAX_UTM_NORTHING - 
ScriptEvent . GetNorthing ( ) ) ; 
ScriptEvent .GetElevat ion { ) ; 

0 . 0 ; 
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Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 



.eye[Y] 

.eye [Z] 

. lookatpt [X] 

. lookatpt [Y] 

. lookatpt [Z] 

. lookf rompt [X] 

. lookf rompt [Y] 

. lookf rompt [Z] 

. direction 
. viewdirection 
. elev 
. gunelev 
. speed 
. roll 
. pitch 
. gas 

. coll_range 



0 . 0 ; 

0 . 0 ; 

0 . 0 ; 

0 . 0 ; 

0 . 0 ; 

0 . 0 ; 

0 . 0 ; 

0 . 0 ; 

ScriptEvent . GetHeading ( ) ; 
0 . 0 ; 

ScriptEvent . GetElevation { ) 
0 . 0 ; 

ScriptEvent . GetVelocity ( ) ; 
0 . 0 ; 

0 . 0 ; 

DEFAULT_VEHICLE_GAS , 

0 . 0 ; 
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